Medifontis
🇮🇹 IT
Ottieni la chiave API

Documentazione / Guide

Cerca farmaci

GET /v1/drugs cerca tra tutti i record di tutte le fonti di un paese per nome, principio attivo o identificativo.

Come funzionano le corrispondenze

  • I nomi corrispondono in qualsiasi punto del testo, quindi basta una parte del nome commerciale per trovarlo.
  • Gli identificativi corrispondono a partire dal primo carattere, quindi l’inizio di un codice trova tutti i record il cui codice inizia con quei caratteri.
  • Accenti e differenze tra maiuscole e minuscole vengono ignorati.
  • La query è testo letterale, senza caratteri jolly né operatori, e deve contenere da 3 a 120 caratteri.

Ordinamento

Prima vengono le corrispondenze esatte, poi i record il cui nome inizia con la query, poi le altre corrispondenze; a parità di posizione, l’ordine è per nome del record.

🇮🇹 Identificativi ricercabili

Questi sono gli schemi di identificazione di ciascuna fonte di questo paese (Italia):

Fonte Ente Record Identificativi
it.aifa.atc
Classificazione ATC 		Agenzia Italiana del Farmaco 7215 atc
it.aifa.equivalents
Farmaci equivalenti 		Agenzia Italiana del Farmaco 8576 aic atc equivalence-group
it.aifa.ingredients
Principi attivi 		Agenzia Italiana del Farmaco 339.110 aic
it.aifa.packages
Confezioni di medicinali 		Agenzia Italiana del Farmaco 160.167 aic atc
it.aifa.shortages
Carenze di medicinali 		Agenzia Italiana del Farmaco 2498 aic atc
it.salute.veterinary-packages
Medicinali veterinari 		Ministero della Salute 11.117 aic gtin

Filtra per tipo di record

Una fonte può pubblicare diversi tipi di record, come confezioni, principi attivi o classi ATC. Passa kinds per mantenere solo quelli che usa la tua applicazione. Il filtro si applica prima della paginazione, quindi i record di altri tipi non possono spingerli fuori da una pagina.

cURL 
curl -G https://api.medifontis.com/v1/drugs \
  -H "Authorization: Bearer $MEDIFONTIS_API_KEY" \
  --data-urlencode "country=it" \
  --data-urlencode "q=tachipirina" \
  --data-urlencode "kinds=it.aifa.packages:packages"

kinds accetta fino a 12 coppie sourceId:kind separate da virgole, tutte del paese richiesto. Una coppia non ben formata, o di un altro paese, restituisce 400.

Filtra per uso e specie

useDomain e species mantengono solo i medicinali per uso umano o veterinario, oppure solo quelli per una determinata specie di destinazione. Medicinali per uso umano e veterinario.

Paginazione

limit imposta la dimensione della pagina, da 1 a 50 (predefinito 20), e offset salta i risultati, fino a 10000. Ogni risposta include nextOffset, l’offset della pagina successiva, oppure null nell’ultima.

Esempio

GET /v1/drugs 
curl -G https://api.medifontis.com/v1/drugs \
  -H "Authorization: Bearer $MEDIFONTIS_API_KEY" \
  --data-urlencode "country=it" \
  --data-urlencode "q=tachipirina"
Risposta 
{
  "country": "it",
  "results": [
    {
      "country": "it",
      "sourceId": "it.aifa.packages",
      "id": "it:aifa:packages:012745016",
      "kind": "packages",
      "name": "TACHIPIRINA",
      "names": [
        "TACHIPIRINA",
        "PARACETAMOLO"
      ],
      "identifiers": [
        {
          "value": "012745016",
          "scheme": "aic"
        },
        {
          "value": "N02BE01",
          "scheme": "atc"
        }
      ],
      "data": {
        "aic": "012745016",
        "atc": "N02BE01",
        "form": "Sciroppo",
        "name": "TACHIPIRINA",
        "holder": "AZIENDE CHIMICHE RIUNITE ANGELINI FRANCESCO A.C.R.A.F. S.P.A.",
        "useDomain": "human"
      },
      "retrievedAt": "2026-10-20T03:30:57.988Z",
      "sourceUrl": "https://drive.aifa.gov.it/farmaci/confezioni_fornitura.csv",
      "licence": {
        "id": "CC-BY-4.0",
        "attribution": "Agenzia Italiana del Farmaco (AIFA)"
      }
    },
    {
      "country": "it",
      "sourceId": "it.aifa.packages",
      "id": "it:aifa:packages:012745028",
      "kind": "packages",
      "name": "TACHIPIRINA",
      "names": [
        "TACHIPIRINA",
        "PARACETAMOLO"
      ],
      "identifiers": [
        {
          "value": "012745028",
          "scheme": "aic"
        },
        {
          "value": "N02BE01",
          "scheme": "atc"
        }
      ],
      "data": {
        "aic": "012745028",
        "atc": "N02BE01",
        "form": "Compressa",
        "name": "TACHIPIRINA",
        "holder": "AZIENDE CHIMICHE RIUNITE ANGELINI FRANCESCO A.C.R.A.F. S.P.A.",
        "useDomain": "human"
      },
      "retrievedAt": "2026-10-20T03:30:57.988Z",
      "sourceUrl": "https://drive.aifa.gov.it/farmaci/confezioni_fornitura.csv",
      "licence": {
        "id": "CC-BY-4.0",
        "attribution": "Agenzia Italiana del Farmaco (AIFA)"
      }
    }
  ],
  "nextOffset": 2
}