cores
radaremprego

API pública

API pública

O que tem

O trabalho que fazemos sobre cada anúncio, em JSON:

  • salário bruto normalizado por mês, se foi confirmado no anúncio, e o líquido estimado
  • profissão ESCO / ISCO-08 e área
  • uma oferta por emprego, com todas as fontes onde aparece (sem duplicados)
  • concelhos e, quando o anúncio o diz, o local de trabalho exato
  • horário (turnos, noites, fins de semana), regime, contrato, requisitos, línguas
  • resumos escritos por IA, em português e em inglês
  • o que o anúncio diz: número de vagas, se pede português, apoio a quem vem de fora (visto, mudança, alojamento), estágio IEFP ou contratação apoiada
  • a data-limite de candidatura, só quando a fonte a diz de facto

O texto original do anúncio não faz parte da API: pertence à sua fonte. Cada oferta traz as ligações para o anúncio original, onde a candidatura acontece.

Pedidos

Cria uma chave (grátis) em conta e envia-a em cada pedido:

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 — ofertas ativas que cumprem o filtro; os parâmetros são os da página de pesquisa (copia o URL de uma pesquisa no site). No máximo 20 por página; segue next.
  • GET /api/v1/jobs/{id} — tudo o que sabemos de uma oferta. Uma oferta juntada a outra (o mesmo anúncio visto duas vezes) responde 308 para essa, com merged_into.
  • lang=en — rótulos, resumos e ligações em inglês.
  • sem_pt=1, apoio=1, vagas=2, iefp=1|estagio|contrato, sort=closing — português não obrigatório, apoio a quem vem de fora, várias vagas, estágio IEFP ou contratação apoiada, prazo mais próximo primeiro.
  • evitar=vendas|publico|telefone, so=vendas — sem vendas, sem atendimento ao público, sem trabalho ao telefone (seja qual for a área); ou só esse tipo de trabalho.

Campos de cada oferta além do salário e da profissão:

  • openings — {min, max, many, label} ou null
  • portuguese — required | plus | not_required | null (o anúncio não diz)
  • support — [{token, text, help}]: visa, relocation, housing, welcome, pt_lessons (ajuda), no_sponsorship, permit_required
  • programme — {kind: internship|hire, label, measures, eligibility} ou null
  • closes_on — data-limite verificada (AAAA-MM-DD) ou null; valid_through é a data da fonte, tal como vem
  • company.id — o valor do filtro company=

Limites

  • 100 pedidos por dia por conta (todas as chaves somadas), renova às 00:00 UTC; mais no Plus.
  • 10 pedidos seguidos, depois um a cada 5 s.
  • Cabeçalhos X-RateLimit-Remaining, X-RateLimit-Reset; acima do limite: 429 com Retry-After.

Sem código

Para mostrar as ofertas de um concelho noutro site, sem chave: uma moldura, um feed RSS ou JSON, e um plugin WordPress, em ofertas para o seu site.

MCP

Servidor MCP com OAuth (descoberta automática, PKCE, registo dinâmico e Client ID Metadata Documents): um cliente MCP só precisa do endereço.

https://radaremprego.pt/api/mcp

100 chamadas de ferramentas por dia. Sem browser: uma chave de conta em Authorization: Bearer emp_…. Ferramentas e esquemas: llms.txt. Passo a passo no Claude e no ChatGPT: usar no Claude ou no ChatGPT.

As ferramentas devolvem os mesmos campos por oferta e aceitam os mesmos filtros: no_portuguese, foreign_support, openings_min, funded, sort: "closing"; get_job junta as palavras do anúncio por trás de cada um.

Condições

  • Mostra a ligação para a oferta ou para o anúncio original junto de cada oferta.
  • Assinala os resumos como escritos por IA.
  • Não revendas os dados como estão.