{ "openapi": "3.0.1", "info": { "title": "elempleo.com Jobs Scraper — Colombia Job Offers & Salaries", "description": "Scrape elempleo.com, a leading Colombian job board: title, company, city, salary band parsed to COP, contract, work modality, keywords. Optional full job page adds 32 fields: full description, expiry date, education, experience, vacancies, schedule, sector. Filters by city, area, salary. No login.", "version": "0.1", "x-build-id": "rEFrOyqgxpqTJuQWJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/oswaldocarabano~elempleo-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-oswaldocarabano-elempleo-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/oswaldocarabano~elempleo-jobs-scraper/runs": { "post": { "operationId": "runs-sync-oswaldocarabano-elempleo-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/oswaldocarabano~elempleo-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-oswaldocarabano-elempleo-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": { "searchQuery": { "title": "Keyword", "type": "string", "description": "Free-text search, exactly like the search box on elempleo.com (job title, skill or company). Letters, numbers, spaces and . , & + # ' ( ) / - only: the site's firewall blocks web addresses and code. Leave empty to get every job offer. Example: \"contador\" matched 593 of 20,876 offers on 30 Sep 2026.", "default": "" }, "cities": { "title": "Cities", "type": "array", "description": "Only job offers located in these cities. Empty = all of Colombia. City names are shown as elempleo.com publishes them.", "items": { "type": "string", "enum": [ "34", "10", "87", "2", "23914", "83", "6", "81", "14", "12", "25585", "8", "25626", "25598", "25590", "25580", "16", "25669", "25655", "25221", "17", "11", "7", "9", "25623", "25684", "1", "12238", "18", "7085", "25595", "24897", "86", "15", "25195", "9102", "21190", "26178", "2514", "25187", "24773", "24712", "25223", "24834", "25600", "82", "15689", "25161", "25183", "25974", "21546", "25523", "25156", "25553", "25738", "24711", "25414", "25279", "25766", "2148" ], "enumTitles": [ "Bogotá", "Medellín", "Cali", "Barranquilla", "Bogotá alrededores", "Bucaramanga", "Cartagena", "Villavicencio", "Pereira", "Neiva", "Chía", "Ibagué", "Mosquera", "Funza", "Cota", "Cajicá", "Santa Marta", "Tocancipá", "Soacha", "Rionegro", "Tunja", "Montería", "Cúcuta", "Manizales", "Madrid", "Zipaquirá", "Armenia", "Palmira", "Valledupar", "Yumbo", "Facatativá", "Barrancabermeja", "Pasto", "Popayán", "Itagui", "Yopal", "Girardot", "Inírida", "Buenaventura", "Girardota", "Duitama", "Florencia", "Sabaneta", "Cartago", "Fusagasugá", "Sincelejo", "Riohacha", "Buriticá", "Envigado", "Girón", "Sin Definir", "Villa Rica", "Bello", "Lorica", "Pitalito", "Sogamoso", "Santa María", "Soledad", "Ciénaga", "Quibdó" ] }, "default": [] }, "areas": { "title": "Job areas", "type": "array", "description": "Only job offers in these job areas (elempleo.com's own taxonomy, e.g. \"Sistemas y Tecnología\"). Empty = every area. An offer can belong to several areas; duplicates are removed.", "items": { "type": "string", "enum": [ "2", "48", "4", "45", "5", "6", "53", "7", "10", "12", "59", "27", "46", "56", "60", "41", "42", "13", "19", "30", "18", "17", "20", "21", "43", "22", "58", "23", "24", "57", "25", "51", "47" ], "enumTitles": [ "Administrativa y Financiera", "Archivo y Documentación", "Auditoría, Contraloría e Interventoría", "Calidad (aseguramiento, gestión y afines)", "Comercial, Ventas y Telemercadeo", "Comercio Exterior", "Compras e Inventarios", "Construcción y Obra", "Docencia", "Gerencia General (cargos corporativos)", "Impuestos, tributario y contable", "Instalación y Reparaciones Técnicas", "Investigación", "Investigacion de Mercados", "Joyería y Relojería", "Jurídica", "Logística y Distribución", "Mantenimiento", "Mercadeo y Publicidad", "Operaciones y Procesos", "Producción", "Proyectos (análisis, desarrollo, gestión y afines)", "Recepción", "Recursos Humanos y Admón. de Personal", "Redacción y Generación de Contenido", "Salud", "Salud ocupacional", "Secretariado", "Seguridad Industrial, Ambiental y Ocupacional", "Seguridad y salud en el trabajo SST", "Servicio al Cliente", "Servicios Generales, Aseo y Vigilancia", "Sistemas y Tecnología" ] }, "default": [] }, "industry": { "title": "Industry (sector of the offer)", "enum": [ "", "123", "114", "134", "125", "124", "106", "110", "115", "107", "113", "102", "130", "105", "111", "135", "138", "129", "120", "103", "126", "128", "101", "122", "127", "117", "132", "118", "104", "112", "139", "136", "116", "121", "109", "137", "119", "108", "131" ], "type": "string", "description": "Only job offers that elempleo.com classifies in this industry. It is the sector of the offer (job_sector on the full job page, 40 of 40 matched in a test on 30 Sep 2026), which can differ from the employer's own industry (company_industry). Empty = every industry.", "default": "" }, "workModality": { "title": "Work modality", "enum": [ "any", "onsite", "hybrid", "remote" ], "type": "string", "description": "On-site, hybrid or remote.", "default": "any" }, "contractType": { "title": "Contract type", "enum": [ "any", "indefinite", "fixed_term", "services", "apprenticeship", "per_project", "other" ], "type": "string", "description": "Type of employment contract as published by the employer.", "default": "any" }, "positionLevel": { "title": "Position level", "enum": [ "any", "operational", "assistant", "professional", "middle_management", "senior_management" ], "type": "string", "description": "Seniority of the role as classified by elempleo.com.", "default": "any" }, "publishedWithin": { "title": "Published within", "enum": [ "any", "last_2_days", "last_week", "last_2_weeks", "last_month" ], "type": "string", "description": "Only job offers published recently.", "default": "any" }, "salaryRanges": { "title": "Salary ranges (COP per month)", "type": "array", "description": "Only job offers in these monthly salary bands, in millions of Colombian pesos, as published by the employer. Empty = any salary, including confidential.", "items": { "type": "string", "enum": [ "2", "3", "4", "5", "6", "7", "8", "9", "10", "23", "27", "28", "29", "30", "31", "32", "33", "35" ], "enumTitles": [ "Menos de $1 million", "$1 a $1,5 million", "$1,5 a $2 million", "$2 a $2,5 million", "$2,5 a $3 million", "$3 a $3,5 million", "$3,5 a $4 million", "$4 a $4,5 million", "$4,5 a $5,5 million", "$5,5 a $6 million", "$6 a $8 million", "$8 a $10 million", "$10 a $12,5 million", "$12,5 a $15 million", "$15 a $18 million", "$18 a $21 million", "Más de $21 million", "Salario confidencial" ] }, "default": [] }, "maxItems": { "title": "Maximum job offers", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Hard cap on job offers delivered and charged in this run. The site returns at most 10,000 results per search; above that the actor splits the search by job area automatically and removes duplicates.", "default": 50 }, "scrapeDetails": { "title": "Include full job page", "type": "boolean", "description": "Also open each job offer page and add 32 fields: full description (the search result cuts ~21% of descriptions), salary range with its unit, expiry date, education level, minimum experience, vacancies, position level, work schedule, professions, company industry and description. Charged as a separate event. One extra request per offer, so runs take longer (measured: 30 offers with pages in 15 s, 50 without in 2 s).", "default": false }, "maxConcurrency": { "title": "Parallel job pages", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many job pages to open at the same time when \"Include full job page\" is on. Measured: 5 in parallel ran at 5.4 pages/s with no refusals. Lower values are slower, not safer.", "default": 3 }, "proxyConfiguration": { "title": "Connection settings", "type": "object", "description": "Optional. Not needed today: elempleo.com answers directly. Only used as a fallback if the site starts refusing requests.", "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 } } } } } } } } } }