Public API
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/mcp100 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.
- Open Customize → Connectors and click "+" / Add.
- 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 - Click "Add", then "Connect".
- The Radar Emprego sign-in page opens: sign in with your email (magic link) or Google.

- Click "allow". The app can then see your saved searches, exclusions and ratings, nothing else. Disconnect in Account → Connected apps.

- 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.
- 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 - Inside Claude Code type /mcp, pick radar-emprego and "Authenticate": your browser opens.
- The Radar Emprego sign-in page opens: sign in with your email (magic link) or Google.
- Click "allow". The app can then see your saved searches, exclusions and ratings, nothing else. Disconnect in Account → Connected apps.
- 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.
- Open Settings → Apps & Connectors → Advanced settings and turn on "Developer mode".
- 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 - The Radar Emprego sign-in page opens: sign in with your email (magic link) or Google.
- Click "allow". The app can then see your saved searches, exclusions and ratings, nothing else. Disconnect in Account → Connected apps.
- In a chat, choose "+" → Developer mode → Radar Emprego and ask your question.
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; follownext.GET /api/v1/jobs/{id}— everything we know about one job. A job folded into another (the same ad seen twice) answers308to that one, withmerged_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}ornullportuguese—required|plus|not_required|null(the ad does not say)support—[{token, text, help}]: visa, relocation, housing, welcome, pt_lessons (help), no_sponsorship, permit_requiredprogramme—{kind: internship|hire, label, measures, eligibility}ornullcloses_on— verified deadline (YYYY-MM-DD) ornull;valid_throughis the source's date as givencompany.id— the value of the filtercompany=
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:429withRetry-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.