Catho API

Search Catho job ads (vagas de emprego) in Brazil and get them as clean JSON.

The API.SH Catho API turns public pages on Catho, the Brazilian job site, into structured JSON. Search vagas by role and city with contract type, salary, work model (remote, hybrid, on site), publication date, job area and disability filters, then open an ad for its company, locations with postal code, contract type, salary and full description.

Get a free API key Try it in the playground

2 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Search Catho jobs

GET https://api.api.sh/catho/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Catho API

Brazilian job market monitoring

Search a role and city on Catho and track openings, companies and salaries over time.

/search

Salary research by role

Collect salary text from ads for a role and city, filtered by contract type such as CLT, to benchmark pay.

/search /job

Remote and hybrid job feeds

Filter by work model and publication date to build feeds of new home office vagas.

/search

Job ad detail for aggregators

Open ads for the full description, company logo and locations to display on your own board.

/job

Catho data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Catho API endpoints and prices

Every Catho endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Search Catho jobs

/catho/v1/search

$1 · $2 PAYG

1 credit

Products, listings and places1

Catho job ad

/catho/v1/job

$1 · $2 PAYG

1 credit

Call the Catho API

Search Catho jobs: GET https://api.api.sh/catho/v1/search

curl "https://api.api.sh/catho/v1/search?q=desenvolvedor" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/catho/v1/search",
    params={"q": "desenvolvedor"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/catho/v1/search");
url.searchParams.set("q", "desenvolvedor");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/catho/v1/search", "q", "desenvolvedor")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Catho" and "Search Catho jobs".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Catho data

Public data only: no Catho login, cookies or account needed
One key and one response shape for Catho and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Catho API

Catho's integrations are for companies using Catho Empresas recruiting tools, not a public API for searching job ads. API.SH reads the public job search and ad pages and returns them as JSON.

There are no maintained Catho scrapers in the search results; API.SH gives you search and job routes with one key and a fixed price per call.

Catho API questions

What Catho data can I get?+

Job search results with title, company, number of openings, city, salary text and date (/catho/v1/search), and one job ad with company and logo, locations with postal code, contract type, salary and full description (/catho/v1/job).

How much does the Catho API cost?+

Every Catho endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /catho/v1/job at 1 credit each.

Does Catho have an API (Catho tem API)?+

Catho Empresas offers integration for recruiters, but there is no public API for reading job ads. API.SH covers that with public data.

Do I need a Catho account or login?+

No. API.SH reads public Catho pages only and does not use a candidate or company login.

Can I filter for remote (home office) jobs?+

Yes. Pass work_model on /catho/v1/search for remote, hybrid or on site, plus posted_within, salary and area filters.

Is this related to Catholic apps called Catho?+

No. This page is about Catho (catho.com.br), the Brazilian job site.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /catho/v1/search with q and location. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.