colours
radaremprego

Public API

Connect an assistant

MCP

To connect Claude, ChatGPT or another assistant to the jobs and your saved searches. You only need this address; there is nothing to fill in, the app asks you to sign in and authorise.

https://radaremprego.com/api/mcp

100 tool calls a day. How to do it in each app: Claude, Claude Code, ChatGPT. For other assistants and programs: llms.txt.

The tools return the same fields per job and take the same filters: no_portuguese, foreign_support, openings_min, funded, sort: "closing"; get_job adds the ad's own words behind each.

Claude (claude.ai, Claude Desktop)

Free (one connector), Pro, Max, Team and Enterprise plans. On Team and Enterprise, an organisation owner adds the connector first.

  1. Open Customize → Connectors and click "+" / Add.
  2. Choose "Add custom connector". Name: Radar Emprego. URL: https://radaremprego.com/api/mcp. Fill in nothing else: the advanced options keep Claude's published identity, no Client ID or secret.
    https://radaremprego.com/api/mcp
  3. Click "Add", then "Connect".
  4. The Radar Emprego sign-in page opens: sign in with your email (magic link) or Google.The Radar Emprego sign-in page opens: sign in with your email (magic link) or Google.
  5. Click "allow". The app can then see your saved searches, exclusions and ratings, nothing else. Disconnect in Account → Connected apps.Click "allow". The app can then see your saved searches, exclusions and ratings, nothing else. Disconnect in Account → Connected apps.
  6. In a chat, turn Radar Emprego on in the "+" menu → Connectors, then ask e.g. "nurse jobs in Coimbra with a salary".

Claude Code

Any Claude Code account.

  1. In a terminal (it is then available in all your projects):
    claude mcp add --transport http --scope user radar-emprego https://radaremprego.com/api/mcp
  2. Inside Claude Code type /mcp, pick radar-emprego and "Authenticate": your browser opens.
  3. The Radar Emprego sign-in page opens: sign in with your email (magic link) or Google.
  4. Click "allow". The app can then see your saved searches, exclusions and ratings, nothing else. Disconnect in Account → Connected apps.
  5. Without a browser (CI, a server): create a key in Account and add to the command:
    --header "Authorization: Bearer emp_…"

ChatGPT

Plus, Pro, Business, Enterprise and Edu plans, on the web (chatgpt.com), with developer mode on.

  1. Open Settings → Apps & Connectors → Advanced settings and turn on "Developer mode".
  2. In Apps & Connectors click "Create". Name: Radar Emprego. MCP server URL: https://radaremprego.com/api/mcp. Authentication: OAuth. Tick "I trust this application" and create.
    https://radaremprego.com/api/mcp
  3. The Radar Emprego sign-in page opens: sign in with your email (magic link) or Google.
  4. Click "allow". The app can then see your saved searches, exclusions and ratings, nothing else. Disconnect in Account → Connected apps.
  5. In a chat, choose "+" → Developer mode → Radar Emprego and ask your question.
public API

What it has

The work we do on each ad, as JSON:

  • gross salary normalised per month, whether the ad confirms it, and the estimated net
  • ESCO / ISCO-08 occupation and area
  • one record per job, with every source it appears on (no duplicates)
  • municipalities and, when the ad says so, the exact workplace
  • schedule (shifts, nights, weekends), work mode, contract, requirements, languages
  • AI-written summaries, in Portuguese and in English
  • what the ad says: number of openings, whether it asks for Portuguese, help for people from abroad (visa, relocation, housing), IEFP internship or supported hire
  • the application deadline, only when the source really states one

The ad's original text is not part of the API: it belongs to its source. Each job carries the links to the original ad, which is where people apply.

Requests

Create a (free) key in account and send it with each request:

curl -H "Authorization: Bearer emp_…" \
  "https://radaremprego.com/api/v1/jobs?concelho=Porto&area=saude&lang=en"

curl -H "Authorization: Bearer emp_…" "https://radaremprego.com/api/v1/jobs/12345"
  • GET /api/v1/jobs — active jobs matching the filter; the parameters are the search page's (copy the URL of a search on the site). At most 20 per page; follow next.
  • GET /api/v1/jobs/{id} — everything we know about one job. A job folded into another (the same ad seen twice) answers 308 to that one, with merged_into.
  • lang=en — English labels, summaries and links.
  • sem_pt=1, apoio=1, vagas=2, iefp=1|estagio|contrato, sort=closing — Portuguese not required, help for people from abroad, several openings, IEFP internship or supported hire, soonest deadline first.
  • evitar=vendas|publico|telefone, so=vendas — no sales, no dealing with the public, no phone work (whatever the area); or only that kind of work.

Fields on each job besides salary and occupation:

  • openings — {min, max, many, label} or null
  • portuguese — required | plus | not_required | null (the ad does not say)
  • support — [{token, text, help}]: visa, relocation, housing, welcome, pt_lessons (help), no_sponsorship, permit_required
  • programme — {kind: internship|hire, label, measures, eligibility} or null
  • closes_on — verified deadline (YYYY-MM-DD) or null; valid_through is the source's date as given
  • company.id — the value of the filter company=

Limits

  • 100 requests a day per account (all keys together), resets at 00:00 UTC; more with Plus.
  • 10 requests in a row, then one every 5 s.
  • Headers X-RateLimit-Remaining, X-RateLimit-Reset; over the limit: 429 with Retry-After.

No code

To show a municipality's jobs on another site, with no key: a frame, an RSS or JSON feed, and a WordPress plugin, at job ads for your website.

Terms

  • Show the link to the job or to the original ad next to each job.
  • Mark the summaries as written by AI.
  • Do not resell the data as it is.
letra A/B