# SpecMatch
> Aggregatore dei concorsi pubblici per medici in Italia (fonti: inPA e Gazzetta Ufficiale 4ª Serie Speciale). Filtra per specializzazione, regione, tipo bando e include un indice di "contendibilità" che stima quanto un bando è realmente aperto (vs costruito su una figura interna).

## API per agenti AI
- Endpoint: `GET https://specmatch.videe.co/api/v1/concorsi`
- Auth: header `Authorization: Bearer <api_key>`. Richiedi una chiave (gratis per i primi iscritti) su https://specmatch.videe.co/api-docs
- Formato: JSON `{ data: [...], pagination: { total, limit, offset } }`
- Filtri (query string): `specializzazione` (es. Cardiologia), `regione` (codice ISTAT, CSV), `tipo` (concorso|incarico|mobilita, CSV), `contendibilita` (aperto|incerto|interno, CSV), `calabria` (1), `scaduti` (1), `limit` (max 100), `offset`
- Ogni concorso include: ente, sede, scadenza, posti, RAL, specializzazione/SSD, link al bando ufficiale, e `contendibilita` { level, score, reasons }

## Documentazione
- https://specmatch.videe.co/api-docs