{ "openapi": "3.0.1", "info": { "title": "Bumeran Jobs Scraper", "description": "[💰 $0.95 / 1K] Extract job listings from Bumeran Argentina. Search by keyword and province, filter by area, seniority, contract type, work mode, and date posted, then collect titles, companies, descriptions, and screening questions — or paste Bumeran search URLs directly.", "version": "1.0", "x-build-id": "Anzx49ZNR096QWJGh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~bumeran-com-ar-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-bumeran-com-ar-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/solidcode~bumeran-com-ar-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-bumeran-com-ar-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/solidcode~bumeran-com-ar-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-bumeran-com-ar-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 Keywords", "maxItems": 50, "type": "array", "description": "Job titles, roles, or keywords to search for, such as 'desarrollador', 'contador', or 'atención al cliente'. Each keyword runs its own search. Leave empty to collect the broadest result set for the chosen location and filters. Up to 50 keywords per run.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "One of Argentina's 23 provinces, such as 'Buenos Aires', 'Córdoba', 'Santa Fe' or 'Mendoza'. Bumeran groups jobs by province, so the City of Buenos Aires (Capital Federal / CABA) is part of Buenos Aires, and city names like Rosario are covered by their province. Leave empty to search all of Argentina." }, "startUrls": { "title": "Direct Bumeran URLs", "maxItems": 50, "type": "array", "description": "Paste full Bumeran search-result or individual job URLs (e.g. https://www.bumeran.com.ar/empleos-busqueda-desarrollador.html) to scrape them directly. Useful when you already have a search dialed in on the website — any filters baked into the URL are respected. Up to 50 URLs per run.", "items": { "type": "string" } }, "area": { "title": "Job Area", "enum": [ "", "administracion-contabilidad-y-finanzas", "ingenieria-civil-y-construccion", "comunicacion-relaciones-institucionales-y-publicas", "aduana-y-comercio-exterior", "atencion-al-cliente-call-center-y-telemarketing", "diseno", "educacion-docencia-e-investigacion", "ingenierias", "gastronomia-y-turismo", "salud-medicina-y-farmacia", "recursos-humanos-y-capacitacion", "seguros", "legales", "gerencia-y-direccion-general", "marketing-y-publicidad", "mineria-petroleo-y-gas", "enfermeria", "produccion-y-manufactura", "comercial-ventas-y-negocios", "secretarias-y-recepcion", "naviero-maritimo-portuario", "sociologia-trabajo-social", "abastecimiento-y-logistica", "departamento-tecnico", "tecnologia-sistemas-y-telecomunicaciones", "oficios-y-otros" ], "type": "string", "description": "Limit results to one job area (área). Leave on 'Any area' to include all areas.", "default": "" }, "seniority": { "title": "Seniority Level", "enum": [ "", "sin-experiencia", "trainee-pasante", "junior", "semi-sr", "senior", "senior-semi-senior", "jefe-supervisor-responsable", "gerencia-alta-gerencia-direccion", "otro" ], "type": "string", "description": "Limit results to one seniority level. Bumeran files ads under nine levels, including a legacy combined 'Senior / Semi-Senior' band that is separate from the standalone Semi-Senior and Senior levels. Leave on 'Any level' to include all.", "default": "" }, "contractType": { "title": "Contract Type", "enum": [ "", "full-time", "part-time", "por-horas", "por-contrato", "temporario", "pasantia", "nocturno", "fines-de-semana" ], "type": "string", "description": "Limit results to one contract or work type. Leave on 'Any' to include all types.", "default": "" }, "workMode": { "title": "Work Mode", "enum": [ "", "presencial", "remoto", "hibrido" ], "type": "string", "description": "Limit results to one work mode (modalidad). Leave on 'Any' to include all modes.", "default": "" }, "datePosted": { "title": "Date Posted", "enum": [ "", "publicacion-hoy", "publicacion-menor-a-2-dias", "publicacion-menor-a-3-dias", "publicacion-menor-a-4-dias", "publicacion-menor-a-5-dias", "publicacion-menor-a-6-dias", "publicacion-menor-a-7-dias", "publicacion-menor-a-15-dias", "publicacion-menor-a-1-mes" ], "type": "string", "description": "Only return jobs published within this time window. Leave on 'Any time' to include all listings.", "default": "" }, "salaryExpectationRequestedOnly": { "title": "Only Jobs That Ask Your Salary Expectation", "type": "boolean", "description": "Keep only listings that require the applicant to state their expected pay. This is Bumeran's own \"salario pretendido\" flag — it does NOT mean the employer published a salary. Employer pay lands in the salary field, which only a minority of Bumeran ads fill in.", "default": false }, "sortBy": { "title": "Sort By", "enum": [ "relevantes", "recientes" ], "type": "string", "description": "Order in which jobs are returned.", "default": "relevantes" }, "maxResultsPerQuery": { "title": "Max Results per Query", "minimum": 0, "type": "integer", "description": "Maximum number of job listings to collect per search keyword (or per start URL). Set to 0 to collect all available results across pagination, up to a safety ceiling of about 10,000 listings per keyword. Results are fetched in pages: the actor stops once your cap is reached but always keeps the whole final page, so a small cap can return up to a full page more than you asked for. Listings repeated across pages are deduplicated, so the final count can also run slightly below your cap.", "default": 100 }, "onlyUniqueJobs": { "title": "Only Unique Jobs", "type": "boolean", "description": "When on, each job is returned once even if Bumeran lists it across several pages or searches. Deduplicates by the listing's job ID. Turn off to keep every copy.", "default": true }, "includeDescription": { "title": "Fetch Extra Details From Each Job Page", "type": "boolean", "description": "Opens every job's own page to add the screening questions applicants must answer, the pay range when the employer publishes one, the área and subárea, the seniority level, the province, and the description with its original formatting. Leave on for the most complete data. Turn off for faster, lighter runs that still give you the job title, company, location, work mode, contract type, posting date, job link and the full description as plain text.", "default": true } } }, "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 } } } } } } } } } }