SM
API

API dei concorsi medici, per il tuo agente AI

Interroga via HTTP i concorsi pubblici per medici (inPA + Gazzetta Ufficiale), con specializzazione, sede e indice di contendibilità — la stima, unica sul mercato, di quanto un bando è realmente aperto. Approviamo ogni richiesta a mano; gratis per i primi 10.

Richiedi la tua chiave

10/10 accessi gratuiti rimasti

Approviamo ogni richiesta manualmente: ti scriviamo via email.

Endpoint

GET https://specmatch.videe.co/api/v1/concorsi

Autenticazione: header Authorization: Bearer <api_key>. Risposta JSON: { data: [...], pagination: { total, limit, offset } }.

Filtri (query string)

specializzazioneDisciplina, es. Cardiologia (match fuzzy su SSD)
regioneCodici regione ISTAT, separati da virgola
tipoconcorso | incarico | mobilita (CSV)
contendibilitaaperto | incerto | interno (CSV)
calabria1 per soli bandi compatibili Decreto Calabria
scaduti1 per includere anche i bandi scaduti
limitRisultati per pagina (default 50, max 100)
offsetScorrimento per la paginazione

Esempio

curl "https://specmatch.videe.co/api/v1/concorsi?specializzazione=Cardiologia&contendibilita=aperto&limit=5" \
  -H "Authorization: Bearer sm_live_..."

Per agenti e crawler AI: /llms.txt. Ogni concorso include contendibilita { level, score, reasons }.