Documentação

API, webhooks e
integrações.

Tudo o que vês no dashboard está acessível via API. Pull dos avisos para o teu CRM, dispara webhooks no teu workflow, integra com o teu pipeline de candidaturas.

Exemplo · GET /v1/avisos

Pedido típico.

# Listar avisos relevantes do perfil padrão
curl -X GET 'https://api.iaportuno.pt/v1/avisos?score_min=70' \
  -H 'Authorization: Bearer iap_live_xxxxx'

{
  "data": [
    {
      "id": "prr-c16-i02",
      "src": "PRR",
      "title": "Digitalização Industrial — Indústria 4.0",
      "score": 92,
      "value_eur": 200000,
      "rate_pct": 75,
      "deadline": "2026-05-14T23:59:00+01:00",
      "match_reasons": ["cae_25_62", "geo_aveiro_convergencia", ...]
    }
  ],
  "page": { "next": null, "total": 14 }
}

Authentication via Bearer token. Rate limits: 60 pedidos/minuto no plano Pro, 600/minuto no plano Agência. Resposta paginada por defeito (100 itens). Suporta filtros ?cae=, ?score_min=, ?source=, ?deadline_before=.