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; seguenext.GET /api/v1/jobs/{id}— tudo o que sabemos de uma oferta. Uma oferta juntada a outra (o mesmo anúncio visto duas vezes) responde308para essa, commerged_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}ounullportuguese—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_requiredprogramme—{kind: internship|hire, label, measures, eligibility}ounullcloses_on— data-limite verificada (AAAA-MM-DD) ounull;valid_throughé a data da fonte, tal como vemcompany.id— o valor do filtrocompany=
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:429comRetry-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/mcp100 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.