Documentation / Guides

Rechercher des médicaments

GET /v1/drugs recherche parmi toutes les fiches de toutes les sources d’un pays, par nom, substance active ou identifiant.

Règles de correspondance

  • Les noms sont recherchés n’importe où dans le texte : une partie d’un nom commercial suffit à le trouver.
  • Les identifiants sont comparés à partir de leur premier caractère : le début d’un code trouve donc toutes les fiches dont le code commence ainsi.
  • Les accents et la casse sont ignorés.
  • Le texte recherché est pris tel quel, sans caractères génériques ni opérateurs, et doit comporter de 3 à 120 caractères.

Classement

Les correspondances exactes viennent en premier, puis les fiches dont le nom commence par le texte recherché, puis les autres correspondances ; en cas d’égalité, les fiches sont triées par nom.

🇨🇦 Identifiants recherchables

Voici les schémas d’identifiants de chaque source de ce pays (Canada):

Source Éditeur Fiches Identifiants
ca.health-canada.dpd
Base de données sur les produits pharmaceutiques (DPD)
Health Canada 58 137 aig dpd-drug-code din atc

Filtrer par type de fiche

Une source peut publier plusieurs types de fiches, comme des conditionnements, des substances actives ou des classes ATC. Utilisez le paramètre kinds pour ne conserver que ceux dont votre application a besoin. Le filtre s’applique avant la pagination : les autres types ne peuvent donc pas les évincer d’une page.

cURL
curl -G https://api.medifontis.com/v1/drugs \
  -H "Authorization: Bearer $MEDIFONTIS_API_KEY" \
  --data-urlencode "country=ca" \
  --data-urlencode "q=metformin" \
  --data-urlencode "kinds=ca.health-canada.dpd:products"

kinds accepte jusqu’à 12 paires sourceId:kind séparées par des virgules, toutes du pays demandé. Une paire mal formée, ou d’un autre pays, renvoie une erreur 400.

Filtrer par usage et par espèce

useDomain et species ne conservent que les médicaments à usage humain ou vétérinaire, ou seulement ceux destinés à une espèce cible. Médicaments à usage humain et vétérinaire.

Pagination

limit définit la taille de la page, de 1 à 50 (20 par défaut), et offset indique combien de résultats ignorer, jusqu’à 10 000. Chaque réponse comporte nextOffset, l’offset de la page suivante, ou null sur la dernière page.

Exemple

GET /v1/drugs
curl -G https://api.medifontis.com/v1/drugs \
  -H "Authorization: Bearer $MEDIFONTIS_API_KEY" \
  --data-urlencode "country=ca" \
  --data-urlencode "q=metformin"
Réponse
{
  "country": "ca",
  "results": [
    {
      "country": "ca",
      "sourceId": "ca.health-canada.dpd",
      "id": "ca:health-canada:products:62265",
      "kind": "products",
      "name": "METFORMIN · 500 MG per TAB · TABLET",
      "names": [
        "METFORMIN · 500 MG per TAB · TABLET",
        "METFORMIN",
        "METFORMIN HYDROCHLORIDE",
        "Chlorhydrate de metformine"
      ],
      "identifiers": [
        {
          "value": "02238827",
          "scheme": "din"
        },
        {
          "value": "62265",
          "scheme": "dpd-drug-code"
        },
        {
          "value": "A10BA02",
          "scheme": "atc"
        },
        {
          "value": "0101773001",
          "scheme": "aig"
        }
      ],
      "data": {
        "din": "02238827",
        "form": "TABLET",
        "name": "METFORMIN · 500 MG per TAB · TABLET",
        "holder": "LABORATOIRES CONFAB INC",
        "drugCode": "62265",
        "brandName": "METFORMIN"
      },
      "retrievedAt": "2026-10-20T06:46:39.902Z",
      "sourceUrl": "https://www.canada.ca/en/health-canada/services/drugs-health-products/drug-products/drug-product-database/what-data-extract-drug-product-database.html",
      "licence": {
        "id": "LicenseRef-Health-Canada-DPD-Reuse-Unconfirmed",
        "attribution": "Source: Health Canada, Drug Product Database (DPD)."
      }
    },
    {
      "country": "ca",
      "sourceId": "ca.health-canada.dpd",
      "id": "ca:health-canada:products:18416",
      "kind": "products",
      "name": "METFORMIN · 500 MG · TABLET",
      "names": [
        "METFORMIN · 500 MG · TABLET",
        "METFORMIN",
        "METFORMIN HYDROCHLORIDE",
        "Chlorhydrate de metformine"
      ],
      "identifiers": [
        {
          "value": "02162822",
          "scheme": "din"
        },
        {
          "value": "18416",
          "scheme": "dpd-drug-code"
        },
        {
          "value": "A10BA02",
          "scheme": "atc"
        },
        {
          "value": "0101773001",
          "scheme": "aig"
        }
      ],
      "data": {
        "din": "02162822",
        "form": "TABLET",
        "name": "METFORMIN · 500 MG · TABLET",
        "holder": "APOTEX INC",
        "drugCode": "18416",
        "brandName": "METFORMIN"
      },
      "retrievedAt": "2026-10-20T06:46:39.902Z",
      "sourceUrl": "https://www.canada.ca/en/health-canada/services/drugs-health-products/drug-products/drug-product-database/what-data-extract-drug-product-database.html",
      "licence": {
        "id": "LicenseRef-Health-Canada-DPD-Reuse-Unconfirmed",
        "attribution": "Source: Health Canada, Drug Product Database (DPD)."
      }
    }
  ],
  "nextOffset": 2
}