{ "openapi": "3.0.1", "info": { "title": "Gupy Jobs Scraper: Brazil Job Vacancies | $0.50 per 1,000", "description": "Scrape Brazilian job postings from Gupy, the hiring system of most large employers in Brazil: title, company, city, state, job type, remote or hybrid, posted and deadline dates, requirements, hiring steps and the reason for the opening. Search by keyword, state, city, company or job type.", "version": "0.1", "x-build-id": "CTrevKeqXEETzTycE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/v0iddo~gupy-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-v0iddo-gupy-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/v0iddo~gupy-scraper/runs": { "post": { "operationId": "runs-sync-v0iddo-gupy-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/v0iddo~gupy-scraper/run-sync": { "post": { "operationId": "run-sync-v0iddo-gupy-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": { "keywords": { "title": "Search terms", "type": "array", "description": "Job titles or words such as analista, desenvolvedor or vendedor. One search per term; leave empty to list every posting that matches the other filters.", "items": { "type": "string" } }, "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": "Only postings in this Brazilian state.", "default": "" }, "city": { "title": "City", "type": "string", "description": "Only postings in this city, written as on Gupy, for example Campinas or Belo Horizonte." }, "workplaceTypes": { "title": "Work mode", "type": "array", "description": "Only these work modes. Leave empty for all.", "items": { "type": "string", "enum": [ "onsite", "hybrid", "remote" ], "enumTitles": [ "Onsite", "Hybrid", "Remote" ] } }, "jobTypes": { "title": "Job types", "type": "array", "description": "Only these job types. Leave empty for all.", "items": { "type": "string", "enum": [ "effective", "internship", "apprentice", "trainee", "temporary", "legal_entity", "freelancer", "autonomous", "talent_pool", "associate", "outsource", "intermittent", "lecturer", "summer", "volunteer", "partner" ], "enumTitles": [ "Permanent (Efetivo)", "Internship (Estágio)", "Apprentice (Aprendiz)", "Trainee", "Temporary (Temporário)", "Contractor (Pessoa Jurídica)", "Freelancer", "Self employed (Autônomo)", "Talent pool (Banco de Talentos)", "Associate (Associado)", "Outsourced (Terceiro)", "Intermittent (Intermitente)", "Lecturer (Docente)", "Summer job", "Volunteer (Voluntário)", "Partner (Sócio)" ] } }, "companies": { "title": "Companies", "type": "array", "description": "Only postings of these employers, by the name their Gupy career page shows, for example Stefanini Group or Raízen.", "items": { "type": "string" } }, "pwdOnly": { "title": "Open to people with disabilities only", "type": "boolean", "description": "Only postings marked as open to people with disabilities (PcD).", "default": false }, "postedWithin": { "title": "Posted within", "enum": [ "any", "1day", "3days", "7days", "15days", "30days" ], "type": "string", "description": "Only postings published in that period.", "default": "any" }, "includeDetails": { "title": "Include posting details", "type": "boolean", "description": "Read each posting's page for the description, responsibilities, requirements and nice to have as separate texts, the full address, the hiring steps, the reason for the opening and the expiry date. Switch it off for a faster run that reads only the search.", "default": true }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 20000, "type": "integer", "description": "The run stops after this many result rows. It also caps what one run can cost.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Leave as is: the run starts on the cheapest network the site accepts and switches to Apify Proxy automatically when the site blocks it. Pick proxy groups here only to force one specific network." } } }, "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 } } } } } } } } } }