# Catho Jobs Scraper / Vagas por Termo (`dadosbr/catho-vagas`) Actor

Search Catho.com.br by term and city and get job title, company, salary when shown and city.

- **URL**: https://apify.com/dadosbr/catho-vagas.md
- **Developed by:** [Dados BR](https://apify.com/dadosbr) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$2.00 / 1,000 result delivereds

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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Catho Jobs Scraper

Searches Catho.com.br by term and city and returns job title, company, salary and city — built for recruiters and analysts mapping the Brazilian job market.

### Use cases

- A recruiter surveys how many roles of a title are open in one city right now, and at what pay.
- A staffing agency tracks the salary ranges companies disclose for a role across regions.
- A job seeker automates a daily digest of new Catho postings matching a keyword.

### Input example

```json
{
  "termo": "vendedor",
  "cidade": "Curitiba PR",
  "maxItems": 30
}
```

`cidade` is optional. Use the city name with the state code ("Curitiba PR", "São Paulo SP"); leave it empty for all of Brazil.

### Output example

Real run on 11/09/2026 with the input above (5 of 30 rows, `coletado_em` and `url_origem` omitted):

```json
{"id": "38329316", "vaga": "Vendedor Interno", "empresa": "GLOBE CONNECT SERVICOS DE MARKETING DIRETO LTDA", "salario": "R$ 1.742", "cidade": "Curitiba", "url": "https://www.catho.com.br/vagas/vendedor-interno/38329316"}
{"id": "38364079", "vaga": "Vendedor", "empresa": "TONY FERNANDO MARTINS", "salario": "R$ 2.500", "cidade": "Curitiba", "url": "https://www.catho.com.br/vagas/vendedor/38364079"}
{"id": "38361730", "vaga": "Vendedor", "empresa": "Empresa Confidencial", "salario": "A partir de R$ 2.000,00 + 1 benefício", "cidade": "Curitiba", "url": "https://www.catho.com.br/vagas/vendedor/38361730"}
{"id": "38361389", "vaga": "Vendedor", "empresa": "ECONOMY ASSESSORIA", "salario": "R$ 1.941 + 5 benefícios", "cidade": "Curitiba", "url": "https://www.catho.com.br/vagas/vendedor/38361389"}
{"id": "38354999", "vaga": "Vendedor", "empresa": "Tayana Vasconcelos de Carvalho", "salario": "Até R$ 2.000,00", "cidade": "Curitiba", "url": "https://www.catho.com.br/vagas/vendedor/38354999"}
```

Every row also carries `coletado_em` (ISO 8601 collection time) and `url_origem`.

### Price

**US$ 2.00 per 1,000 results, no subscription.** You pay only for jobs delivered to the dataset.

### How to use

- **API**: call the Actor's `run-sync-get-dataset-items` endpoint with `termo`, optional `cidade` and `maxItems`.
- **Scheduled**: run daily with Apify Schedules to catch new postings in a city.
- **Integrations**: n8n, Make or Zapier via the official Apify app, straight into a spreadsheet or CRM.

### Limitations

- Catho has no public API; the Actor reads the public search pages over HTTP (no browser), rotating the proxy IP when Catho refuses one.
- `salario` is the text Catho shows on the card ("R$ 2.500", "A combinar", "Até R$ 2.000,00 + 1 benefício"), not a parsed number.
- Small businesses (MEI) are often listed under the owner's name; the Actor removes any CPF number from the company field.
- If Catho changes its layout, the run fails with a clear error instead of returning an empty dataset. Open an issue and it will be fixed.

This Actor collects only public data and respects Catho's terms of use.

***

### Em português

Para um termo de busca e uma cidade opcional ("Curitiba PR"), devolve vagas do Catho com empresa, salário e cidade. Serve para recrutador mapear quantas vagas de um cargo existem numa cidade e quanto pagam, agência de recrutamento acompanhar faixa salarial por região e candidato receber um resumo diário de vagas novas.

**Preço: US$ 2,00 por 1.000 resultados, sem mensalidade.**

# Actor input Schema

## `termo` (type: `string`):

Job title or keyword to search (e.g. "vendedor").

## `cidade` (type: `string`):

City name, best with the state code (e.g. "Curitiba PR", "São Paulo SP"). Leave empty for all of Brazil.

## `maxItems` (type: `integer`):

Maximum number of results to return.

## `proxyConfiguration` (type: `object`):

Datacenter proxy is used by default.

## Actor input object example

```json
{
  "termo": "vendedor",
  "cidade": "",
  "maxItems": 30,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

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

// Prepare Actor input
const input = {
    "termo": "vendedor"
};

// Run the Actor and wait for it to finish
const run = await client.actor("dadosbr/catho-vagas").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 = { "termo": "vendedor" }

# Run the Actor and wait for it to finish
run = client.actor("dadosbr/catho-vagas").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 '{
  "termo": "vendedor"
}' |
apify call dadosbr/catho-vagas --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dadosbr/catho-vagas"
        }
    }
}

```

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/X2y9e4MM0Jjq7lg5R/builds/wSyn8wrczzchUDhry/openapi.json