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.pt/api/v1/jobs?concelho=Porto&area=saude&lang=en" curl -H "Authorization: Bearer emp_…" "https://radaremprego.pt/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.
MCP
MCP server with OAuth (automatic discovery, PKCE, dynamic registration and Client ID Metadata Documents): an MCP client only needs the address.
https://radaremprego.pt/api/mcp100 tool calls a day. Without a browser: a key from account in Authorization: Bearer emp_…. Tools and schemas: llms.txt. Step by step in Claude and ChatGPT: use it in Claude or ChatGPT.
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.
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.