Vagas API

Job ads from VAGAS.com.br, one of Brazil's largest job sites, as JSON.

The API.SH Vagas API returns public job data from VAGAS.com.br in Brazil. Search jobs by keyword and city, sorted by relevance or newest, with the total and filter counts by work model, contract, state, level, area and benefits, then open any job ad for its full description, company, locations, employment type, dates, salary when given and openings.

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 jobs in Brazil

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

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Vagas API

Brazilian job aggregators

Pull VAGAS.com.br jobs by keyword and city into a job board or Telegram and email alerts.

/search /job

Hiring market research in Brazil

Use filter counts by state, level, area and work model to measure demand for a role.

/search

Company hiring tracking

Watch which companies post new jobs, with the number of openings for each ad.

/search /job

Job description datasets

Collect full Portuguese job descriptions for skills analysis or training job-matching models.

/job

Vagas data you get

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

Vagas API endpoints and prices

Every Vagas 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 jobs in Brazil

/vagas/v1/search

$1 · $2 PAYG

1 credit

Products, listings and places1

VAGAS.com.br job ad

/vagas/v1/job

$1 · $2 PAYG

1 credit

Call the Vagas API

Search jobs in Brazil: GET https://api.api.sh/vagas/v1/search

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

import os, requests

res = requests.get(
    "https://api.api.sh/vagas/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/vagas/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("/vagas/v1/search", "q", "desenvolvedor")

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

# 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 Vagas data

Public data only: no Vagas login, cookies or account needed
One key and one response shape for Vagas 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 Vagas API

VAGAS.com.br does not offer a public jobs API for developers; its integrations are for companies using its recruiting software. API.SH returns the public job search and job ads as JSON.

Skip writing a VAGAS.com.br scraper in Python or maintaining one from GitHub: one API.SH key returns Brazilian job ads at a fixed price per call.

Vagas API questions

What VAGAS.com.br data can I get?+

Job search by keyword and city with totals and filter counts (/vagas/v1/search) and one job ad with full description, company, locations, employment type, posting and closing dates, salary when given and openings (/vagas/v1/job).

How much does the Vagas API cost?+

Every Vagas 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 /vagas/v1/job at 1 credit each.

Is there an official Vagas API?+

No public one. VAGAS.com.br sells recruiting software to companies but does not publish an open jobs API. API.SH reads the public job pages and returns them as JSON.

Do I need a VAGAS.com.br account or login?+

No. API.SH reads public VAGAS.com.br pages only. No endpoint uses a login, cookies or anyone's account, and it does not apply to jobs or send resumes.

Can I use it from Python?+

Yes. Send a GET request with your API.SH key using requests or the API.SH Python SDK, and you get JSON back with no scraper to maintain.

Is the data in Portuguese?+

Yes. Job titles, descriptions and filter names come as VAGAS.com.br shows them, in Portuguese. Keywords and city names can be passed the same way you would type them on the site.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /vagas/v1/search with q and city, then /vagas/v1/job with an id from the results. Every parameter is 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.