{ "openapi": "3.0.1", "info": { "title": "Bumeran Jobs Scraper - Latin America Job Listings", "description": "Scrape job postings from Bumeran across Argentina, Mexico, Peru, Chile, Ecuador, Panama and Venezuela. Get job title, company, area, employment type, seniority, salary when shown, work modality, location, posted date, full description and a direct apply URL. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "O6emQnvshijVfXhT7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~bumeran-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-bumeran-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/scrapers_lat~bumeran-jobs-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-bumeran-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/scrapers_lat~bumeran-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-bumeran-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": { "keywords": { "title": "Keywords Or Search URLs", "type": "array", "description": "One or more search terms (for example 'desarrollador', 'ventas', 'contador') or full Bumeran search URLs. Each item runs its own search and results are combined. Leave a single empty item to fetch all jobs in the selected country.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "AR", "MX", "PE", "CL", "EC", "PA", "VE" ], "type": "string", "description": "Which Bumeran country site to search.", "default": "AR" }, "maxJobs": { "title": "Max Jobs To Scrape", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of job postings to collect across all searches. Optional." }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Only return jobs whose work modality is remote / work-from-home.", "default": false }, "withSalaryOnly": { "title": "Only jobs with a published salary", "type": "boolean", "description": "Only return jobs that publish a salary range.", "default": false }, "postedWithinDays": { "title": "Posted within N days", "minimum": 1, "type": "integer", "description": "Only return jobs posted within this many days. Leave empty for no date limit." }, "seniority": { "title": "Seniority contains", "type": "string", "description": "Only return jobs whose seniority level contains this text (e.g. 'Senior', 'Junior', 'Semi'). Case-insensitive." }, "employmentType": { "title": "Employment type contains", "type": "string", "description": "Only return jobs whose employment type contains this text (e.g. 'Full', 'Part', 'Temporario'). Case-insensitive." }, "withJdSummary": { "title": "AI job summary (paid add-on)", "type": "boolean", "description": "Optional paid AI add-on, off by default. Adds a concise 2-3 sentence English summary of each job description. Billed per job only when a summary is produced. Requires a paid Apify plan.", "default": false }, "withSkills": { "title": "AI skills & seniority (paid add-on)", "type": "boolean", "description": "Optional paid AI add-on, off by default. Extracts required skills, technologies/tools and a seniority level as structured English tags from each job description. Billed per job only when tags are produced. Requires a paid Apify plan.", "default": false }, "withSalaryEstimate": { "title": "AI salary estimate (paid add-on)", "type": "boolean", "description": "Optional paid AI add-on, off by default. Estimates a market salary range (min/max, currency, basis) for jobs that do not publish a salary, from the title, location and description. Billed per job only when an estimate is produced. Requires a paid Apify plan.", "default": false }, "withTranslate": { "title": "AI translate to English (paid add-on)", "type": "boolean", "description": "Optional paid AI add-on, off by default. Translates each job title and description into English. Billed per job only when a translation is produced. Requires a paid Apify plan.", "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 } } }, "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 } } } } } } } } } }