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):

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

São Paulo, remoto ou híbrido:

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

Alertas diários (só vagas novas):

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

Só Gupy, CLT:

{"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):

{
  "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:

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}'

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.