{ "openapi": "3.0.1", "info": { "title": "Gupy Jobs Scraper | Brazil Jobs and Employers", "description": "Gupy scraper for Vagas Gupy across Brazil: 50 jobs in 14 seconds, 79 fields each. Search by keyword, state, city, company or Gupy link and get the full description, requirements, benefits, hiring steps, contract type, address, application deadline and the employer's website and LinkedIn page.", "version": "1.0", "x-build-id": "nXZQ8xifW3dvhYhNm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/silentflow~gupy-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-silentflow-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/silentflow~gupy-jobs-scraper/runs": { "post": { "operationId": "runs-sync-silentflow-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/silentflow~gupy-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-silentflow-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": { "searchQueries": { "title": "🔎 Keywords", "type": "array", "description": "Job titles, roles or skills to search on the Gupy portal, as you would type them there: analista, desenvolvedor, vendedor, estágio. Each keyword is searched on its own, newest jobs first. A common keyword returns thousands of jobs across Brazil. Leave everything empty to read the newest jobs on Gupy.", "items": { "type": "string" } }, "startUrls": { "title": "🔗 Gupy links", "type": "array", "description": "Paste any Gupy link:", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "companyIds": { "title": "🏢 Companies", "type": "array", "description": "Read every open job of a company: its Gupy name is the word before .gupy.io in its career page address, such as ambev, renner or cogna. The location, workplace and job type filters apply.", "items": { "type": "string" } }, "state": { "title": "🗺️ State", "type": "string", "description": "A Brazilian state. Pick one or type its code (SP) or its name (São Paulo, accents optional)." }, "city": { "title": "🏙️ City", "type": "string", "description": "A city as Gupy writes it, with its accents: Campinas, Belo Horizonte, Florianópolis." }, "maxItems": { "title": "🔢 Max jobs", "minimum": 1, "type": "integer", "description": "The run stops once this many jobs are saved, across all keywords, links and companies. Set it to what you need: the run time grows with it, 30 to 40 seconds per 100 jobs on our test runs.", "default": 100 }, "workplaceType": { "title": "🏠 Workplace", "enum": [ "any", "remote", "hybrid", "on-site" ], "type": "string", "description": "Remote, hybrid or on-site jobs only.", "default": "any" }, "jobType": { "title": "📄 Job type", "enum": [ "any", "vacancy_type_effective", "vacancy_legal_entity", "vacancy_type_internship", "vacancy_type_apprentice", "vacancy_type_trainee", "vacancy_type_temporary", "vacancy_type_freelancer", "vacancy_type_autonomous", "vacancy_type_outsource", "vacancy_type_talent_pool", "vacancy_type_volunteer", "vacancy_type_lecturer", "vacancy_type_associate", "vacancy_type_summer" ], "type": "string", "description": "One contract type: full-time employee (CLT), PJ contractor, internship, apprentice, trainee, temporary and more.", "default": "any" }, "postedWithinDays": { "title": "📅 Posted in the last (days)", "minimum": 1, "type": "integer", "description": "Only jobs published in the last N days, such as 7 for a weekly feed. Leave empty for every open job." }, "debugMode": { "title": "🐞 Debug mode", "type": "boolean", "description": "Write detailed logs.", "default": 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 } } } } } } } } } }