colours
radaremprego

Public API

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; 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.

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/mcp

100 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.