# elempleo Colombia Job Listings Scraper (`scrapers_lat/elempleo-scraper`) Actor
Scrape elempleo.com job listings in Colombia. Extract title, company, salary, location, contract type, work mode and full descriptions.
- **URL**: https://apify.com/scrapers\_lat/elempleo-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Jobs, Business, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars
## Pricing
from $8.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
[](https://console.apify.com/actors/VQgP2SkLQfe17Dz0H/input)
## elempleo Scraper
> Extract job listings from elempleo.com, Colombia's leading job board, with salary, contract type, work mode and full descriptions
15 fields per record
Colombia coverage
JSON / CSV / Excel output formats
Updated 2026-06-19
### What you get
Each record is one job offer from elempleo.com with the data shown on the search results and, optionally, the full detail page. Use it to build job feeds, track hiring demand, analyze salaries, or power a recruitment dataset.
- **title**: job offer title
- **company**: hiring company name, or "Empresa confidencial" when the employer is hidden on the listing
- **location**: city or region of the job
- **salary**: published salary range or "Salario confidencial"
- **contractType**: contract type (Indefinido, Por obra o labor, Definido, etc.)
- **workMode**: work modality (Presencial, Remoto, HΓbrido)
- **publishedDate**: when the offer was published, as shown on the site (e.g. "Ayer", "Hace 4 horas")
- **jobId**: unique elempleo offer id
- **url**: direct link to the job offer page
- **description\***: full job description text
- **requirements\***: key requirements and skills listed on the offer
- **education\***: required education level (Universitaria, Tecnico Laboral, Media, etc.)
- **experience\***: required minimum experience
- **companyProfile\***: company name and sector, revealing the real employer even on confidential listings
- **observedAt**: when this listing was last seen by the scraper
*\*These fields only appear when withDetails is set to true.*
### Who is it for
| Use case | Who benefits |
|---|---|
| Aggregating Colombian job offers into a single feed | Job boards and meta-search sites |
| Tracking hiring demand by role, city or sector | Labor market analysts |
| Benchmarking salaries and contract types | HR and compensation teams |
| Sourcing leads of actively hiring companies | Recruiters and staffing agencies |
| Building training data for job-matching models | Data scientists and HR-tech builders |
### Frequently Asked Questions
**Which country and site does this scraper cover?**
It covers elempleo.com, Colombia's leading job board. Paste any search or listing URL from the site, including URLs with city, keyword or other filters already applied, and the scraper follows pagination automatically.
**How many job offers can I collect in one run?**
There is no fixed cap. Use the Max Items input to set how many offers to collect. The scraper pages through results until it reaches your limit or runs out of offers, typically about 20 listings per page.
**Can I filter the jobs I scrape?**
Yes. Apply any filters on elempleo.com first (city, keyword, salary, contract, etc.), then paste the resulting URL as the Search URL. The scraper respects whatever filtering is encoded in that URL.
**What is the difference between the basic and detailed output?**
By default the scraper returns the listing-level fields shown on the search results. Enable Fetch job details to also open each job page and add description, requirements, education, experience and the company profile, which reveals the real employer even for confidential offers.
**What happens when a field is missing on the source?**
Fields like salary or work mode are returned as null when the offer does not publish them. If a detail page cannot be reached after retries, that single offer is recorded with an error field instead of stopping the run.
### Example use cases
Ready-to-run example tasks, each preconfigured for a common scenario. Open one and press run, or use it as a template:
- [elempleo Bogota Sales Jobs](https://apify.com/scrapers_lat/elempleo-scraper/examples/elempleo-bogota-sales-jobs): Collect sales and commercial job openings in Bogota from elempleo with company, salary range and requirements.
- [elempleo Colombia Job Listings](https://apify.com/scrapers_lat/elempleo-scraper/examples/elempleo-colombia-all-jobs): Scrape job postings from elempleo across Colombia with title, company, salary, location and full description.
- [elempleo Software Developer Jobs](https://apify.com/scrapers_lat/elempleo-scraper/examples/elempleo-software-developer-jobs): Track software and IT developer job postings in Colombia from elempleo with company, salary and skills required.
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [LinkedIn Job Listings Scraper](https://apify.com/scrapers_lat/linkedin-jobs-scraper): Extract public LinkedIn job postings by keyword and location worldwide. Scrape job title, company...
- [Computrabajo Job Listings Scraper](https://apify.com/scrapers_lat/computrabajo-scraper): Extract job listings from Computrabajo across 19 LATAM countries. Scrape titles, companies...
- [Workable Job Listings Scraper](https://apify.com/scrapers_lat/workable-scraper): Extract public job listings from any Workable-hosted company careers board by account name or board...
- [Talent.com Job Listings Scraper](https://apify.com/scrapers_lat/talent-jobs-scraper): Extract public Talent.com job listings by keyword, location and country: title, company, salary...
- [GetOnBrd Tech Jobs & Salary Scraper](https://apify.com/scrapers_lat/getonbrd-scraper): Extract LATAM tech jobs and salary data from GetOnBrd. Scrape job title, company, category...
- [Dice Tech Job Listings Scraper](https://apify.com/scrapers_lat/dice-jobs-scraper): Extract public Dice.com tech job postings by keyword and location: title, company, location...
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with elempleo.com. It only accesses data that is publicly available on the platform. Use it in accordance with elempleo.com's terms of service.
# Actor input Schema
## `maxItems` (type: `integer`):
Maximum number of job listings to collect. Optional.
## `withDetails` (type: `boolean`):
When enabled, the actor opens each job page to add description, requirements, education, experience, and company profile. This is slower and makes one request per job.
## `startUrl` (type: `string`):
An elempleo.com job search or listing URL to scrape, for example https://www.elempleo.com/co/ofertas-empleo/ or a URL with filters applied on the site (city, keyword, etc.). Paste the resulting URL after filtering. Pagination is followed automatically.
## Actor input object example
```json
{
"maxItems": 10,
"withDetails": true,
"startUrl": "https://www.elempleo.com/co/ofertas-empleo/"
}
````
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxItems": 10,
"startUrl": "https://www.elempleo.com/co/ofertas-empleo/"
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/elempleo-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`πΎ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// π Want to learn more π? Go to β https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"maxItems": 10,
"startUrl": "https://www.elempleo.com/co/ofertas-empleo/",
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/elempleo-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("πΎ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# π Want to learn more π? Go to β https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxItems": 10,
"startUrl": "https://www.elempleo.com/co/ofertas-empleo/"
}' |
apify call scrapers_lat/elempleo-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/elempleo-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "elempleo Colombia Job Listings Scraper",
"description": "Scrape elempleo.com job listings in Colombia. Extract title, company, salary, location, contract type, work mode and full descriptions.",
"version": "0.1",
"x-build-id": "sksxfZiFBr8Zap6rx"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~elempleo-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-elempleo-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~elempleo-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-elempleo-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~elempleo-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-elempleo-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",
"required": [
"startUrl"
],
"properties": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of job listings to collect. Optional."
},
"withDetails": {
"title": "Fetch job details",
"type": "boolean",
"description": "When enabled, the actor opens each job page to add description, requirements, education, experience, and company profile. This is slower and makes one request per job.",
"default": true
},
"startUrl": {
"title": "Search URL",
"type": "string",
"description": "An elempleo.com job search or listing URL to scrape, for example https://www.elempleo.com/co/ofertas-empleo/ or a URL with filters applied on the site (city, keyword, etc.). Paste the resulting URL after filtering. Pagination is followed automatically."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```