# Chiletrabajos Jobs Scraper: Chile Job Listings (`santamaria-automations/chiletrabajos-jobs-scraper`) Actor

Scrape job listings from Chiletrabajos, a large Chilean job board: title, company, city, posting date, benefits and the full description. Filter by keyword, city, category and job type. Pay-per-result.

- **URL**: https://apify.com/santamaria-automations/chiletrabajos-jobs-scraper.md
- **Developed by:** [NanoScrape](https://apify.com/santamaria-automations) (community)
- **Categories:** Jobs, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Chiletrabajos Jobs Scraper

Scrape job listings from Chiletrabajos ([chiletrabajos.cl](https://www.chiletrabajos.cl/)), a large job board in Chile. You get the title, company, city, posting date, benefits and, with the job page, the category, job type, contract duration, deadline, tags and the full description for every job. Search by keyword, city, category, job type, posting date and company.

### What you get

- One row per job, with a clean ISO posting date and the original site text next to it.
- Optionally the job page of each row: full title, category, job type, contract duration, deadline, tags, view counts and the description as HTML and plain text.
- Each job once per run, even when several keywords find it.
- A run with no input returns the newest 5 jobs.

### Use with AI Agents (MCP)

Connect this actor to any MCP-compatible AI client: Claude Desktop, Claude.ai, Cursor, VS Code, LangChain, LlamaIndex, or custom agents.

**Apify MCP server URL:**

`https://mcp.apify.com?tools=santamaria-automations/chiletrabajos-jobs-scraper`

**Example prompt once connected:**

> "Use `chiletrabajos-jobs-scraper` to find up to 5 jobs for the keyword "vendedor" (sales roles in Santiago). Return results as a table with title, company, location and job URL."

Clients that support dynamic tool discovery (Claude.ai, VS Code) receive the full input schema automatically.

### Input

Every field is optional. Example:

```json
{
  "includeDetails": false,
  "maxResults": 5,
  "maxResultsPerQuery": 5,
  "searchQueries": [
    "vendedor"
  ]
}
```

| Field | What it does |
|---|---|
| `searchQueries` | Keywords such as vendedor or contador. Each keyword is its own search. |
| `location` | One city of the site's city list, for example Santiago, Concepcion or Valparaiso. Names, site slugs and site codes work. |
| `category` | One of the 21 site categories, for example Informatica / Telecomunicaciones or Ventas / Comercial. |
| `jobType` | part-time, full-time or part-time-full-time. |
| `postedWithin` | today, since-yesterday, 3-days, 6-days, week or month. |
| `company` | Company name to search for. |
| `inclusionLaw` | Only employers eligible under the Chilean inclusion law. |
| `sortBy` | date (default) or relevance. |
| `maxResultsPerQuery` | Jobs per keyword. Default 50, up to 1000. |
| `maxResults` | Jobs in total. 0 means no limit. |
| `includeDetails` | Read each job page for the extra fields. Default false. |

### Sample output

```json
{
  "id": "3926231",
  "title": "Analista SEO Semi Senior",
  "title_truncated": false,
  "company": "Empresa del sector bancario",
  "company_initials": "ED",
  "company_color": "#C62828",
  "company_logo": null,
  "location": "Santiago",
  "location_slug": "santiago",
  "location_url": "https://www.chiletrabajos.cl/ciudad/santiago.html",
  "region_code": "RM",
  "postal_code": "8320000",
  "country": "CL",
  "category": "Marketing y Publicidad",
  "category_slug": "marketing",
  "category_url": "https://www.chiletrabajos.cl/trabajos/marketing",
  "job_type": "Full-time",
  "job_type_slug": "full-time",
  "contract_duration": "Plazo fijo, posterior indefinido",
  "posted_text": "10 de Noviembre de 2026",
  "date_posted": "2026-11-10",
  "date_posted_time": "2026-11-10T00:44:01",
  "valid_through": "2027-01-24T00:44:01",
  "expires_text": "2027-01-24 (en 75 días)",
  "featured": true,
  "inclusion_law": true,
  "benefits": [],
  "tags": [
    "seo",
    "contenidos",
    "web"
  ],
  "views": 490,
  "interested": 18,
  "snippet": "Analista seo buscamos un/a analista seo con experiencia en optimización de sitios web…",
  "description_html": "Analista SEO<br/>\n<br/>\nBuscamos un/a Analista SEO con experiencia en optimización de sitios web y contenidos digitales, responsable de impl…",
  "description_text": "Analista SEO\n\nBuscamos un/a Analista SEO con experiencia en optimización de sitios web y contenidos digitales, responsable de implementar me…",
  "job_url": "https://www.chiletrabajos.cl/trabajo/analista-seo-semi-senior-3926231",
  "details_fetched": true,
  "search_query": "vendedor",
  "source": "chiletrabajos.cl",
  "scraped_at": "2026-11-10T12:00:00Z"
}
```

### Fields

Fields that only the job page carries are `null` when `includeDetails` is off. The salary, workday, experience and region fields, and `extra_fields`, are left out of a row when the ad shows no such value.

| Field | Type | Description |
|---|---|---|
| `id` | string | Numeric id at the end of the job address. It is the dedup key. |
| `title` | string | Job title. On result pages long titles are shortened by the site (see title_truncated); with includeDetails the full title is used. |
| `title_truncated` | boolean | true when the title comes from a result card and the site cut it with an ellipsis. Always false when the job page was read. |
| `company` | string or null | Company as shown by the site. Many ads show a description such as "Empresa del sector bancario" instead of a name. |
| `company_initials` | string or null | Letters of the placeholder badge shown when the company has no logo. |
| `company_color` | string or null | Background color of the placeholder badge (hex). |
| `company_logo` | string or null | Address of the company logo when the company has one. |
| `location` | string or null | City of the job. |
| `location_slug` | string or null | City part of the site address /ciudad/<slug>.html. |
| `location_url` | string or null | Address of the site page that lists jobs in this city. |
| `region_code` | string or null | Region code of the job location (job page only), for example RM. |
| `postal_code` | string or null | Postal code of the job location (job page only). |
| `country` | string or null | Country code of the job location (job page only). |
| `category` | string or null | Job category (job page only). |
| `category_slug` | string or null | Category part of the site address /trabajos/<slug> (job page only). |
| `category_url` | string or null | Address of the site page that lists jobs in this category (job page only). |
| `job_type` | string or null | Full-time, Part-time or Part-time & Full-time (job page only). |
| `job_type_slug` | string or null | Type part of the site address /tipo/<slug>.html (job page only). |
| `contract_duration` | string or null | Duration text of the contract as the site shows it (job page only). |
| `posted_text` | string or null | Posting date as shown by the site, for example 10 de Noviembre de 2026. |
| `date_posted` | string or null | Posting date as ISO date (YYYY-MM-DD). |
| `date_posted_time` | string or null | Posting date and time as ISO 8601 without zone, in the site local time (job page only). |
| `valid_through` | string or null | Deadline of the ad as ISO 8601 without zone (job page only). |
| `expires_text` | string or null | Expiry as shown by the site, with the days left at the time of the read (job page only). |
| `featured` | boolean | true when the site marks the ad as "Oferta destacada". |
| `inclusion_law` | boolean | true when the employer is eligible under the Chilean inclusion law (ley de inclusion). |
| `benefits` | array | Company benefits shown as icons on the card, for example mutual de seguridad or uniform. Empty list when none. |
| `tags` | array | Keywords the employer attached to the ad (job page only). Empty list when none. |
| `views` | integer or null | How often the ad was viewed (job page only). |
| `interested` | integer or null | Number of people interested in the ad (job page only). |
| `snippet` | string or null | Start of the description from the result card, cut by the site with an ellipsis. |
| `description_html` | string or null | Full description as HTML (job page only). |
| `description_text` | string or null | Full description as plain text with line breaks (job page only). |
| `job_url` | string | Address of the job page. |
| `details_fetched` | boolean | true when the job page was read (includeDetails). |
| `search_query` | string | The keyword of the search that found the job, or the filters used when no keyword was given. |
| `source` | string | Site host. |
| `scraped_at` | string | ISO 8601 UTC time of the read. |
| `salary_text` | string or null | Salary row of the job page when the ad shows one. Left out of the row when the ad has no salary. |
| `salary_amount` | number or null | Salary amount from the job page data when it is above 0. Left out of the row otherwise. |
| `salary_currency` | string or null | Currency of salary_amount. Left out of the row when there is no amount. |
| `salary_period` | string or null | Period of salary_amount (month, hour, ...). Left out of the row when there is no amount. |
| `workday` | string or null | Workday row of the job page when the ad shows one. Left out of the row otherwise. |
| `experience` | string or null | Experience row of the job page when the ad shows one. Left out of the row otherwise. |
| `region` | string or null | Region row of the job page when the ad shows one. Left out of the row otherwise. |
| `extra_fields` | object or null | Any other row of the job page table that this actor does not know yet, label to text. Left out of the row when there are none. |

### Pricing

This Actor uses pay per event. There is a small `apify-actor-start` event when a run starts and one `job-result` event for each job in the dataset. You are never charged for a job twice, and a run stops when it reaches the maximum charge you set.

Price: $0.001 start fee per run, then $0.0012 per job result ($1.20 per 1,000 jobs).

**New to Apify?** Every account gets a $5 free monthly platform credit, enough to try this actor at no cost.

### Related Actors

- [Computrabajo Jobs Scraper: Empleos, Salaries, 19 Countries](https://apify.com/santamaria-automations/computrabajo-scraper): Job listings from Computrabajo in 19 Latin American and Spanish-speaking countries.
- [InfoJobs Scraper - Spanish Job Listings & Salaries | $3/1K Jobs](https://apify.com/santamaria-automations/infojobs-scraper): Spanish job listings and salaries from InfoJobs.
- [Indeed Jobs Scraper - 60+ Countries, $0.06 per 1,000 Jobs](https://apify.com/santamaria-automations/indeed-http-scraper): Indeed jobs in over 60 countries.

### FAQ

**Why do many companies look like "Empresa del sector bancario"?**
Chiletrabajos lets employers hide their name. The site then shows a short description instead, and that text is what you get in `company`.

**Why are some titles and snippets cut off?**
The result list shortens long titles and descriptions with an ellipsis. `title_truncated` tells you when that happened. With `includeDetails` on you get the full title and the full description.

**Is there a salary?**
Most ads show none, and the site then stores 0. The salary fields appear in a row only when the ad shows a salary. Contact e-mails are behind a login on the site and are never returned.

**What happens when a keyword finds nothing?**
The run ends normally with the status "0 jobs found for <keyword>." and nothing is charged. The site shows suggested jobs under such a search; they are not returned.

### Support

Something broken, or a field you wish this Actor returned? Open a ticket on the Actor's [Issues tab](https://apify.com/santamaria-automations/chiletrabajos-jobs-scraper/issues) or email contact@nanoscrape.com. We usually respond within one working day.

# Changelog

This Actor's version history is a separate document: https://apify.com/santamaria-automations/chiletrabajos-jobs-scraper/changelog.md

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords such as vendedor, contador or chofer. Each keyword runs as its own search on Chiletrabajos; a job found by several keywords is returned once. Leave empty to list the newest jobs (or the jobs of the filters only).

## `location` (type: `string`):

One city of the site's city list, for example Santiago, Concepcion, Valparaiso, Antofagasta, Rancagua, La Serena or Temuco. A value that is not in the list finds no jobs.

## `category` (type: `string`):

One category: Administracion, Arte/Diseno/Medios, Asistente administrativo, Economia / Contabilidad, Educacion y Psicopedagogia, Estetica y Cuidado Personal, Hoteleria Turismo y Gastronomia, Informatica / Telecomunicaciones, Profesionales y Tecnicos, Logistica / Distribucion, Marketing y Publicidad, Medicina / Salud, Operarios, Otros, Practicas profesionales, Recepcion / Secretaria, Seguridad, Ventas / Comercial, Servicios Domesticos, Recursos Humanos or Trabajos Universitarios.

## `jobType` (type: `string`):

One of part-time, full-time or part-time-full-time (Part-time & Full-time).

## `postedWithin` (type: `string`):

One of today, since-yesterday, 3-days, 6-days, week or month (the choices of the site's date filter).

## `company` (type: `string`):

Company name to search for, as in the site's company field.

## `inclusionLaw` (type: `boolean`):

Only jobs of employers that are eligible under the Chilean inclusion law.

## `sortBy` (type: `string`):

date (newest first, default) or relevance.

## `maxResultsPerQuery` (type: `integer`):

Maximum number of jobs per keyword (or in total when no keyword is set). 0 = up to 1000.

## `maxResults` (type: `integer`):

Maximum number of jobs in the dataset across all searches. 0 = no limit.

## `includeDetails` (type: `boolean`):

Read each job page for the full title and description, category, job type, contract duration, deadline, tags and view counts. Turn on when you need the full text; off gives the list fields faster.

## Actor input object example

```json
{
  "inclusionLaw": false,
  "maxResultsPerQuery": 50,
  "maxResults": 0,
  "includeDetails": false
}
```

# Actor output Schema

## `jobs` (type: `string`):

Dataset with the scraped Chiletrabajos job listings.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("santamaria-automations/chiletrabajos-jobs-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("santamaria-automations/chiletrabajos-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call santamaria-automations/chiletrabajos-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,santamaria-automations/chiletrabajos-jobs-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/orDeWbO5gY4AdymSQ/builds/Wp7FrbygYnBSGfhGx/openapi.json
