# Gupy.io – Public Jobs, Companies & Hiring Badges (`abotapi/gupy-io-scraper`) Actor Scrape public jobs from Gupy.io. Search by keyword, state, city, workplace type, job type, company, PWD, and feedback badge. Returns rich job, company, deadline, and badge fields. - **URL**: https://apify.com/abotapi/gupy-io-scraper.md - **Developed by:** [AbotAPI](https://apify.com/abotapi) (community) - **Categories:** Jobs, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 job results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Gupy.io Jobs Scraper Scrape public job listings from Gupy.io. The actor supports keyword search, Brazilian state and city filters, workplace model, job type, exact Gupy career page name, PWD-only listings, feedback-badge companies, URL mode, optional detail enrichment, and newest/oldest/company sorting. ### Pricing Pay per event: | Event | Price | | --- | ---: | | Actor start | $0.08 | | Job result | $0.002 | | Detail enrichment | $0.0008 | Base result pricing is $2.00 per 1,000 saved jobs plus the run-start event. Detail enrichment adds $0.80 per 1,000 enriched jobs when enabled. ### Input Use Search mode for filters: ```json { "searchTerm": "developer", "state": "São Paulo", "workplaceTypes": ["remote"], "sortBy": "newest", "fetchDetails": true, "maxItems": 20 } ```` Use URL mode for portal search URLs or company job URLs: ```json { "mode": "url", "urls": [ "https://portal.gupy.io/job-search/term=developer", "https://sejaesm.gupy.io/job/eyJqb2JJZCI6MTE1MjA0MzksInNvdXJjZSI6Imd1cHlfcG9ydGFsIn0=?jobBoardSource=gupy_portal" ], "maxItems": 5 } ``` `maxItems` is the only finite default cap and means the maximum matching rows to save. Fewer rows may be returned when the selected source, keyword, and filters match fewer live records. `maxPages` is unlimited by default; set it only when you want to stop after a fixed number of API pages. ### Export to your apps (MCP connectors) Optionally pipe results into Notion, Linear, Airtable, or any Apify-supported MCP server. Authorize a connector once under **Apify → Settings → Integrations**, then select it in the **Export to your apps** input. Each connector receives a condensed, human-readable summary per job (title + key fields); the full record always stays in the dataset. For Notion, also set **Notion parent page**. Use **Max jobs to export per connector** to cap how many jobs are written per run. This is a fail-safe side channel — connector errors never affect the scrape or the dataset. ### Output Each result includes job identifiers, title, URL, HTML and plain-text description, location, job type, workplace type, remote flag, publication and application deadline dates, company/career page metadata, badge/PWD flags, source fields, and a scrape timestamp. ### Proxy Guidance Apify Proxy with datacenter IPs is sufficient for Gupy and is the default. Running without Apify Proxy (direct or free-plan) may be rate-limited; if you see repeated source errors, enable Apify Proxy. Residential is rarely needed. ### Notes The actor extracts public job data. Users are responsible for compliance with applicable laws, platform terms, and privacy obligations. # Actor input Schema ## `mode` (type: `string`): Search mode uses the filters below. URL mode accepts portal search URLs and Gupy company job URLs. ## `searchTerm` (type: `string`): Job title, skill, or keyword. Leave empty to scrape all jobs matching the other filters. ## `state` (type: `string`): Brazilian state filter. Leave empty for all states. ## `cities` (type: `array`): Exact Gupy city names. Leave empty for all cities. ## `workplaceTypes` (type: `array`): Remote, hybrid, or on-site jobs. Leave empty for all workplace types. ## `jobTypes` (type: `array`): Gupy vacancy type values. Leave empty for all job types. ## `companies` (type: `array`): Exact Gupy career page names, for example '#sejaveriter' or 'PagBank'. Leave empty for all companies. ## `pwdOnly` (type: `boolean`): Return only jobs marked for people with disabilities. ## `friendlyBadgeOnly` (type: `boolean`): Return only jobs from companies with Gupy feedback badge. ## `urls` (type: `array`): Portal search URLs or Gupy company job URLs. Used only when Mode is URLs. ## `fetchDetails` (type: `boolean`): Fetch the full per-job record before saving each result. Applies to Search mode and to portal search URLs. Direct Gupy job URLs are always fetched in full, so this toggle does not affect them. Adds the detail-enrichment charge per enriched job. ## `sortBy` (type: `string`): Sort saved jobs after collection. Applies in both Search and URL mode. ## `maxItems` (type: `integer`): Maximum matching rows to save. Fewer rows may be returned when the selected source, keyword, and filters match fewer live records. ## `maxPages` (type: `integer`): No page limit by default. Leave empty or set 0 for unlimited; the run stops at Max items. ## `pageSize` (type: `integer`): API page size. Larger pages are faster; smaller pages are useful for debugging. ## `mcpConnectors` (type: `array`): Optionally send the scraped jobs into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per job (title + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com). ## `notionParentPageUrl` (type: `string`): URL (or id) of the Notion page under which job pages are created. Required to enable the Notion export; ignored by other connectors. ## `maxNotifyListings` (type: `integer`): Cap on jobs written to each connector per run. Does not affect the dataset. ## `proxyConfiguration` (type: `object`): Apify datacenter proxy is sufficient for Gupy and is the default. Running without Apify Proxy may be rate-limited; residential is rarely needed. ## Actor input object example ```json { "mode": "search", "searchTerm": "developer", "state": "", "cities": [], "workplaceTypes": [], "jobTypes": [], "companies": [], "pwdOnly": false, "friendlyBadgeOnly": false, "urls": [], "fetchDetails": false, "sortBy": "newest", "maxItems": 20, "maxPages": 0, "pageSize": 100, "maxNotifyListings": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [] } } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchTerm": "developer", "sortBy": "newest", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [] } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/gupy-io-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchTerm": "developer", "sortBy": "newest", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": [], }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/gupy-io-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchTerm": "developer", "sortBy": "newest", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [] } }' | apify call abotapi/gupy-io-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/gupy-io-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Gupy.io – Public Jobs, Companies & Hiring Badges", "description": "Scrape public jobs from Gupy.io. Search by keyword, state, city, workplace type, job type, company, PWD, and feedback badge. Returns rich job, company, deadline, and badge fields.", "version": "1.0", "x-build-id": "g46mBN9SE7WK5HGkX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~gupy-io-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-gupy-io-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/abotapi~gupy-io-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-gupy-io-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/abotapi~gupy-io-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-gupy-io-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "Search mode uses the filters below. URL mode accepts portal search URLs and Gupy company job URLs.", "default": "search" }, "searchTerm": { "title": "Search keyword", "type": "string", "description": "Job title, skill, or keyword. Leave empty to scrape all jobs matching the other filters.", "default": "" }, "state": { "title": "State", "enum": [ "", "Acre", "Alagoas", "Amapá", "Amazonas", "Bahia", "Ceará", "Distrito Federal", "Espírito Santo", "Goiás", "Maranhão", "Mato Grosso", "Mato Grosso do Sul", "Minas Gerais", "Pará", "Paraíba", "Paraná", "Pernambuco", "Piauí", "Rio de Janeiro", "Rio Grande do Norte", "Rio Grande do Sul", "Rondônia", "Roraima", "Santa Catarina", "São Paulo", "Sergipe", "Tocantins" ], "type": "string", "description": "Brazilian state filter. Leave empty for all states.", "default": "" }, "cities": { "title": "Cities", "type": "array", "description": "Exact Gupy city names. Leave empty for all cities.", "items": { "type": "string" }, "default": [] }, "workplaceTypes": { "title": "Workplace types", "type": "array", "description": "Remote, hybrid, or on-site jobs. Leave empty for all workplace types.", "items": { "type": "string", "enum": [ "remote", "hybrid", "on-site" ], "enumTitles": [ "Remote", "Hybrid", "On-site" ] }, "default": [] }, "jobTypes": { "title": "Job types", "type": "array", "description": "Gupy vacancy type values. Leave empty for all job types.", "items": { "type": "string", "enum": [ "vacancy_type_effective", "vacancy_type_apprentice", "vacancy_type_internship", "vacancy_legal_entity", "vacancy_type_trainee", "vacancy_type_temporary", "vacancy_type_freelancer", "vacancy_type_outsource", "vacancy_type_talent_pool", "vacancy_type_volunteer", "vacancy_type_parter", "vacancy_type_summer", "vacancy_type_intermittent" ], "enumTitles": [ "Full-time (Effective)", "Apprentice", "Internship", "Legal Entity", "Trainee", "Temporary", "Freelancer", "Outsourced", "Talent Pool", "Volunteer", "Partner", "Summer Job", "Intermittent" ] }, "default": [] }, "companies": { "title": "Companies", "type": "array", "description": "Exact Gupy career page names, for example '#sejaveriter' or 'PagBank'. Leave empty for all companies.", "items": { "type": "string" }, "default": [] }, "pwdOnly": { "title": "Only PWD-accessible jobs", "type": "boolean", "description": "Return only jobs marked for people with disabilities.", "default": false }, "friendlyBadgeOnly": { "title": "Only feedback-badge companies", "type": "boolean", "description": "Return only jobs from companies with Gupy feedback badge.", "default": false }, "urls": { "title": "URLs", "type": "array", "description": "Portal search URLs or Gupy company job URLs. Used only when Mode is URLs.", "items": { "type": "string" }, "default": [] }, "fetchDetails": { "title": "Fetch details", "type": "boolean", "description": "Fetch the full per-job record before saving each result. Applies to Search mode and to portal search URLs. Direct Gupy job URLs are always fetched in full, so this toggle does not affect them. Adds the detail-enrichment charge per enriched job.", "default": false }, "sortBy": { "title": "Sort order", "enum": [ "newest", "oldest", "company" ], "type": "string", "description": "Sort saved jobs after collection. Applies in both Search and URL mode.", "default": "newest" }, "maxItems": { "title": "Max items", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum matching rows to save. Fewer rows may be returned when the selected source, keyword, and filters match fewer live records.", "default": 20 }, "maxPages": { "title": "Max pages", "minimum": 0, "maximum": 10000, "type": "integer", "description": "No page limit by default. Leave empty or set 0 for unlimited; the run stops at Max items.", "default": 0 }, "pageSize": { "title": "Page size", "minimum": 1, "maximum": 100, "type": "integer", "description": "API page size. Larger pages are faster; smaller pages are useful for debugging.", "default": 100 }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send the scraped jobs into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per job (title + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which job pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max jobs to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on jobs written to each connector per run. Does not affect the dataset.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify datacenter proxy is sufficient for Gupy and is the default. Running without Apify Proxy may be rate-limited; residential is rarely needed.", "default": { "useApifyProxy": true, "apifyProxyGroups": [] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```