# Brazil Jobs Scraper: Catho, Gupy & Vagas.com.br (Vagas Emprego) (`datadesk-io/brazil-jobs-scraper`) Actor

Scrape Brazilian job listings from Catho, Gupy and Vagas.com.br in one run: title, company, salary in BRL (monthly + yearly), city and state (UF), remote/hybrid/on-site, contract type (CLT, PJ, estágio), posting date and URL. Job alerts mode returns only new vagas. No login. $1.50 per 1,000 jobs.

- **URL**: https://apify.com/datadesk-io/brazil-jobs-scraper.md
- **Developed by:** [DataDesk](https://apify.com/datadesk-io) (community)
- **Categories:** Jobs, Lead generation
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 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

## Brazil Jobs Scraper: Catho, Gupy & Vagas.com.br (Vagas de Emprego)

Scrape Brazilian job listings from **Catho (catho.com.br), Gupy (portal.gupy.io) and Vagas.com.br** in one run: title, company, **salary in BRL** (monthly and yearly), **city and state (UF)**, **remote / hybrid / on-site**, **contract type (CLT, PJ, estágio, temporário)**, posting date, application deadline and job URL. No login, no browser, no proxy setup. $1.50 per 1,000 jobs.

**Português:** Extraia vagas de emprego do Brasil na **Catho, Gupy e Vagas.com.br** em uma única execução: cargo, empresa, **salário em R$**, **cidade e UF**, **remoto / híbrido / presencial**, **tipo de contrato (CLT, PJ, estágio)**, data de publicação e link da vaga. Sem login. Modo alerta: receba só vagas novas todos os dias.

### What you can do / O que dá para fazer

- Daily job alerts for a role and state (e.g. *desenvolvedor* in SP) / alertas diários de vagas novas
- Salary benchmarks in BRL by role and city (Catho publishes salaries) / pesquisa salarial
- CLT vs PJ and remote vs on-site analysis / análise CLT x PJ e remoto x presencial
- Lead lists of companies hiring in Brazil right now / lista de empresas contratando

### Sources and coverage

| Source | Coverage | Data |
|---|---|---|
| **Catho** | Brazil (all states) | title, company, city, salary, contract type, full description (details on) |
| **Gupy** | Brazil (company career pages on Gupy) | title, company, city, workplace type, PcD flag, deadline |
| **Vagas.com.br** | Brazil | title, company, city, level, snippet, date |

### How to use it

1. Click **Try for free** (or **Start**): the prefilled input runs a quick test.
2. Fill in the input fields (see the examples below). Every field is optional.
3. Click **Start** and wait a few seconds to minutes, depending on how many jobs you ask for.
4. Open the **Output** tab and export as **JSON, CSV, Excel, XML or HTML**, or read the results via API.

### Input examples

**Vagas de desenvolvedor (padrão):**

```json
{"keywords": ["desenvolvedor"], "sources": ["catho", "gupy", "vagas"], "maxJobsPerSearch": 20}
```

**São Paulo, remoto ou híbrido:**

```json
{"keywords": ["analista de dados"], "state": "SP", "workplaceTypes": ["remote", "hybrid"], "maxJobsPerSearch": 100}
```

**Alertas diários (só vagas novas):**

```json
{"keywords": ["vendedor", "motorista"], "postedWithinDays": 1, "onlyNewJobs": true, "alertsKey": "vendas-br"}
```

**Só Gupy, CLT:**

```json
{"keywords": ["enfermeiro"], "sources": ["gupy"], "contractTypes": ["CLT"]}
```

#### Input fields

| Field | Type | Description |
|---|---|---|
| `keywords` | array | Job titles or skills, e.g. desenvolvedor, vendedor, analista financeiro. One search per keyword and site. |
| `sources` | array | Job boards to search: Catho, Gupy and/or Vagas.com.br. Each keyword is searched on every selected board. Empty = all three. |
| `state` | string | Two-letter state, e.g. SP, RJ, MG. Empty = all Brazil. Remote jobs are always kept. |
| `city` | string | e.g. São Paulo, Campinas. Works best together with the state (UF). |
| `workplaceTypes` | array | remote / hybrid / on-site. Gupy and Vagas report it; Catho rows have no workplace field, so a filter drops Catho rows. Empty = all. |
| `contractTypes` | array | Only jobs with these contract types (CLT, PJ, estágio, temporário...). Leave empty to get every contract type. |
| `maxJobsPerSearch` | integer | Cap per keyword and site. Gupy returns up to 100 per search. You only pay for jobs saved. |
| `cathoDetails` | boolean | Opens each Catho job page to read CLT/PJ, state and an exact date. Slower; turn off for speed. |
| `postedWithinDays` | integer | Only jobs posted in the last N days. 0 = any date. |
| `onlyNewJobs` | boolean | Remember jobs from earlier runs and save only jobs you have not received before. Schedule daily for an alert feed. You pay only for new jobs. |
| `alertsKey` | string | Separate memory per alert (e.g. "dev-sp"). |

### Output example

One row per item. Values below are **example values** from a real test run (long text shortened):

```json
{
  "source": "catho",
  "jobId": "38631824",
  "title": "Programador de solda automática",
  "company": "FEEDER",
  "city": "São Paulo",
  "state": "SP",
  "location": "São Paulo, SP",
  "country": "BR",
  "contractType": "CLT",
  "salary": "A partir de R$ 4.000,00",
  "salaryMin": 4000.0,
  "salaryCurrency": "BRL",
  "salaryPeriod": "month",
  "salaryYearlyMin": 53320,
  "postedAt": "2026-09-30T23:59:59Z",
  "descriptionSnippet": "OPERAR DE MAQUINA DE SOLDA E PROGRAMAR O ROBÔ, CONDUZIR PROCESSOS PRODUTIVOS DE OPERAÇÕES COM ROBÔS, PREPARAR ROBÔS PARA OPERAÇÃO, CONTROLAR…",
  "url": "https://www.catho.com.br/vagas/programador-de-solda-automatica/38631824/",
  "keyword": "desenvolvedor"
  "…": "more fields below"
}
```

Fields a source does not publish are `null`.

#### Output fields

| Field | Description |
|---|---|
| `source` | Site the job came from |
| `jobId` | Requisition id (e.g. JR2028817) |
| `title` | Job title |
| `company` | Company name (built-in list) or Workday tenant |
| `city` | City |
| `state` | State code |
| `location` | Location as shown |
| `country` | Country (with details on) |
| `workplaceType` | remote, hybrid or onsite (null if unknown) |
| `isRemote` | True for remote jobs |
| `contractType` | Contract type (permanent, contract, temporary...) |
| `salary` | Salary as shown |
| `salaryMin` | Lowest salary found in the description |
| `salaryMax` | Highest salary found in the description |
| `salaryCurrency` | Salary currency (USD, EUR, ...) |
| `salaryPeriod` | year, month or hour |
| `salaryYearlyMin` | Minimum salary converted to a yearly amount |
| `salaryYearlyMax` | Maximum salary converted to a yearly amount |
| `postedAt` | Posting date (YYYY-MM-DD; exact with details on, else derived from 'Posted N days ago') |
| `applicationDeadline` | Application deadline, if the posting shows one |
| `descriptionSnippet` | Short excerpt of the job description |
| `url` | Job posting URL |
| `keyword` | Search keyword that found the job |
| `salaryNegotiable` | True if salary is marked negotiable / "a combinar" |
| `openings` | Number of open positions |
| `scrapedAt` | Scrape time (ISO, UTC) |
| `isNew` | True if no earlier run with the same state key returned this job |
| `companyLogo` | Company logo URL |
| `isPwdFriendly` | True if the job is open to people with disabilities (PcD) |
| `seniority` | intern, junior, mid, senior or lead, guessed from the title (null if unclear) |

The Output tab has a **Jobs** view.

### Pricing

Pay-per-event: you pay only for results delivered, no monthly fee.

- **Job** (`job`): **$1.50 per 1,000** ($0.0015 each)
- **Actor start:** $0.005 per run

| Run | Jobs | Cost |
|---|---|---|
| Quick test | 20 | $0.035 |
| Small run | 100 | $0.155 |
| Regular run | 1,000 | $1.505 |
| Large run | 10,000 | $15.005 |

Rows that are not delivered are never charged. Apify's free plan includes monthly credit, and you can set a maximum cost per run in the run options.

### Use cases

- Painel diário de vagas por cargo e cidade
- Benchmark de salários no Brasil
- Leads B2B: empresas que estão contratando agora
- Alimentar job boards e agentes de IA

### Integrations and API

- Export results as JSON, CSV, Excel, XML or HTML from the Output tab.
- **Schedule** runs (daily, hourly) and send results to Google Sheets, Slack, Zapier, Make, n8n, Airbyte or webhooks.
- Call it from code with the [Apify API](https://docs.apify.com/api/v2):

```bash
curl -X POST "https://api.apify.com/v2/acts/datadesk-io~brazil-jobs-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["desenvolvedor"], "sources": ["catho", "gupy", "vagas"], "maxJobsPerSearch": 20}'
```

```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_TOKEN")
run = client.actor("datadesk-io/brazil-jobs-scraper").call(run_input={'keywords': ['desenvolvedor'], 'sources': ['catho', 'gupy', 'vagas'], 'maxJobsPerSearch': 20})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get('title'), item.get('company'), item.get('url'))
```

### FAQ

**Do I need a login, API key or proxies?** No. It uses publicly available data only, so no account on the source site is needed.

**How fresh is the data?** Live: every run reads the source at that moment. Schedule it to keep a dataset up to date.

**Why did I get fewer jobs than the maximum?** The source had fewer matching jobs, or duplicates were removed. You only pay for jobs delivered.

**Is it legal?** It collects only publicly available data. You are responsible for using it in line with applicable laws (e.g. GDPR) and the source's terms.

### Limitations

- Gupy's public portal returns at most 100 jobs per search; add a state or city to get more distinct jobs.
- Salaries come only from Catho (Gupy and Vagas.com.br listings don't publish them). "A combinar" → `salaryNegotiable: true`.
- Catho cards don't carry remote/hybrid; a workplace filter keeps only Gupy and Vagas rows.
- InfoJobs Brasil is **not** included (it blocks automated access).

### Support

Found a bug, or need a new field, source or filter? Open an issue in the **Issues** tab; we usually answer within 24 hours. Custom data work: datadesk.io@proton.me.

# Actor input Schema

## `keywords` (type: `array`):

Job titles or skills, e.g. desenvolvedor, vendedor, analista financeiro. One search per keyword and site.

## `sources` (type: `array`):

Job boards to search: Catho, Gupy and/or Vagas.com.br. Each keyword is searched on every selected board. Empty = all three.

## `state` (type: `string`):

Two-letter state, e.g. SP, RJ, MG. Empty = all Brazil. Remote jobs are always kept.

## `city` (type: `string`):

e.g. São Paulo, Campinas. Works best together with the state (UF).

## `workplaceTypes` (type: `array`):

remote / hybrid / on-site. Gupy and Vagas report it; Catho rows have no workplace field, so a filter drops Catho rows. Empty = all.

## `contractTypes` (type: `array`):

Only jobs with these contract types (CLT, PJ, estágio, temporário...). Leave empty to get every contract type.

## `maxJobsPerSearch` (type: `integer`):

Cap per keyword and site. Gupy returns up to 100 per search. You only pay for jobs saved.

## `cathoDetails` (type: `boolean`):

Opens each Catho job page to read CLT/PJ, state and an exact date. Slower; turn off for speed.

## `postedWithinDays` (type: `integer`):

Only jobs posted in the last N days. 0 = any date.

## `onlyNewJobs` (type: `boolean`):

Remember jobs from earlier runs and save only jobs you have not received before. Schedule daily for an alert feed. You pay only for new jobs.

## `alertsKey` (type: `string`):

Separate memory per alert (e.g. "dev-sp").

## Actor input object example

```json
{
  "keywords": [
    "desenvolvedor"
  ],
  "sources": [
    "catho",
    "gupy",
    "vagas"
  ],
  "maxJobsPerSearch": 20,
  "cathoDetails": true,
  "onlyNewJobs": false
}
```

# Actor output Schema

## `jobs` (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 = {
    "keywords": [
        "desenvolvedor"
    ],
    "sources": [
        "catho",
        "gupy",
        "vagas"
    ],
    "maxJobsPerSearch": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("datadesk-io/brazil-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 = {
    "keywords": ["desenvolvedor"],
    "sources": [
        "catho",
        "gupy",
        "vagas",
    ],
    "maxJobsPerSearch": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("datadesk-io/brazil-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 '{
  "keywords": [
    "desenvolvedor"
  ],
  "sources": [
    "catho",
    "gupy",
    "vagas"
  ],
  "maxJobsPerSearch": 20
}' |
apify call datadesk-io/brazil-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,datadesk-io/brazil-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/aXHXUwpQ91kxeeLcy/builds/dGzkOpmKaP5yUMcjr/openapi.json