Gupy Jobs Scraper
Pricing
from $1.64 / 1,000 results
Scrape public Gupy job listings and return each job's title, company, description, location, work mode, contract type, publish date, deadline and application URL. Search by keywords or filter by state, city, work mode, contract type or PcD status; results from multiple queries are deduplicated.
You can access the Gupy Jobs Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.1", "x-build-id": "iYd7VJ0bBqGQXmceJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axiomworks~gupy-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axiomworks-gupy-jobs-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/axiomworks~gupy-jobs-scraper/runs": { "post": { "operationId": "runs-sync-axiomworks-gupy-jobs-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/axiomworks~gupy-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-axiomworks-gupy-jobs-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Job keywords to search on Gupy, one per line, e.g. 'desenvolvedor' or 'analista de dados' (Portuguese works best, accents allowed). Each term is a separate search filtered by the fields below. Leave empty to list all open jobs that match the filters. A term with no matches returns 0 items, not an error.", "items": { "type": "string" } }, "startUrls": { "title": "Gupy search URLs", "type": "array", "description": "portal.gupy.io search links copied from the browser, e.g. [{\"url\": \"https://portal.gupy.io/job-search/term=vendedor&state=São Paulo&workplaceTypes[]=on-site\"}]. Plain URL strings also work. The term, state, city, work-mode, job-type, company and PwD filters in the link are used; fields below fill in only what the link leaves out. Company career sites (*.gupy.io) are not supported." }, "companyName": { "title": "Company name", "type": "string", "description": "Only jobs from this company, written exactly as Gupy shows it (case-sensitive), e.g. 'Cresol Oficial'. A partial or misspelled name returns 0 items." }, "state": { "title": "State", "type": "string", "description": "Brazilian state, full name as Gupy writes it, e.g. 'São Paulo', 'Paraná', 'Minas Gerais'. Remote jobs have no state, so combining this with work mode 'remote' usually returns nothing." }, "city": { "title": "City", "type": "string", "description": "City name, e.g. 'Curitiba' or 'Manaus'. Works alone or together with state." }, "workplaceTypes": { "title": "Work mode", "type": "array", "description": "Work modes to include: 'remote', 'hybrid', 'on-site'. Empty = all. Each value is searched separately and merged, so maxItems may be filled by the first value before the next one is reached.", "items": { "type": "string", "enum": [ "remote", "hybrid", "on-site" ], "enumTitles": [ "Remote", "Hybrid", "On-site" ] }, "default": [] }, "jobTypes": { "title": "Job types", "type": "array", "description": "Contract types to include, e.g. 'vacancy_type_effective' (CLT), 'vacancy_type_internship' (estágio), 'vacancy_type_apprentice', 'vacancy_type_trainee', 'vacancy_type_temporary', 'vacancy_legal_entity' (PJ). Empty = all. Each value is a separate search, merged and de-duplicated.", "items": { "type": "string", "enum": [ "vacancy_type_effective", "vacancy_type_internship", "vacancy_type_apprentice", "vacancy_type_trainee", "vacancy_type_temporary", "vacancy_type_talent_pool", "vacancy_legal_entity", "vacancy_type_autonomous", "vacancy_type_freelancer", "vacancy_type_associate", "vacancy_type_lecturer", "vacancy_type_volunteer", "vacancy_type_summer", "vacancy_type_outsource", "vacancy_type_intermittent", "vacancy_type_parter" ], "enumTitles": [ "Effective (CLT)", "Internship (estágio)", "Apprentice (jovem aprendiz)", "Trainee", "Temporary", "Talent pool", "Legal entity (PJ)", "Autonomous", "Freelancer", "Associate", "Lecturer", "Volunteer", "Summer job", "Outsourced", "Intermittent", "Partner" ] }, "default": [] }, "pwdOnly": { "title": "Only jobs for people with disabilities (PcD)", "type": "boolean", "description": "If true, return only jobs Gupy flags for people with disabilities (PcD / isPWD). Default false returns all jobs.", "default": false }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of jobs to return in total, shared across all search terms, URLs and filter values, 1-10000, default 50. The run stops as soon as this many are saved, and you are charged only for results returned. One search can reach about 10,000 jobs; narrow by state, city or work mode to go deeper.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy for requests, default none (direct). Rate-limited or blocked requests are retried through Apify Proxy anyway; turn it on here only if runs keep getting blocked.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Gupy Jobs Scraper from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: