atlas

DOCS

Sommaire Démarrage Indicateurs & catalogue Pays & séries Régions & sous-Atlas Capture & export Compte & clés API Billing Tarifs

Indicateurs & catalogue

Ce groupe de routes sert à découvrir, chercher et explorer le catalogue d'indicateurs Atlas — toutes sources confondues (World Bank, Data360, OWID, Eurostat, Banque de France…). Il ne renvoie aucune valeur de série par pays : pour ça, voir « Pays & séries ».

GET /api/indicators GET /api/stats GET /api/sources GET /api/indicators/explore GET /api/indicators/search GET /api/catalog/browse GET /api/indicator/{code}/meta

GET/api/indicators

Catalogue curaté (117 indicateurs), groupé par thème, pour le sélecteur principal du front. La langue des libellés suit l'en-tête Accept-Language.

Erreurs génériques : voir Démarrage.

CURL

curl -H "X-API-Key: $ATLAS_KEY" \
  "https://atlasfeed.fr/api/indicators"

PYTHON

import requests

r = requests.get(
    "https://atlasfeed.fr/api/indicators",
    headers={"X-API-Key": ATLAS_KEY},
)
r.raise_for_status()
data = r.json()

JAVASCRIPT

const r = await fetch("https://atlasfeed.fr/api/indicators", {
  headers: { "X-API-Key": ATLAS_KEY },
});
const data = await r.json();

RÉPONSE

{
  "themes": [
    {
      "theme": "Économie",
      "indicators": [
        {
          "code": "NY.GDP.MKTP.CD",
          "label": "PIB",
          "theme": "Économie",
          "unit": "US$ courants",
          "fmt": "currency",
          "headline": true,
          "source": "worldbank",
          "forecastable": true
        }
      ]
    }
  ],
  "total": 18003
}

total compte l'intégralité de catalog.BY_CODE (longue traîne comprise), pas seulement les indicateurs listés dans themes.

GET/api/stats

Chiffres globaux (pays, indicateurs, sources) affichés sur les pages marketing — dérivés du catalogue réel, jamais recopiés à la main.

Erreurs génériques : voir Démarrage. Dégrade silencieusement (hérite du repli de /api/countries) si World Bank est injoignable.

CURL

curl -H "X-API-Key: $ATLAS_KEY" \
  "https://atlasfeed.fr/api/stats"

PYTHON

import requests

r = requests.get(
    "https://atlasfeed.fr/api/stats",
    headers={"X-API-Key": ATLAS_KEY},
)
data = r.json()

JAVASCRIPT

const r = await fetch("https://atlasfeed.fr/api/stats", {
  headers: { "X-API-Key": ATLAS_KEY },
});
const data = await r.json();

RÉPONSE

{"countries": 216, "indicators": 18003, "sources": 18}

GET/api/sources

Sources effectivement servies par au moins un indicateur du catalogue (intersection registre d'attribution × catalogue réel), pour la page publique des sources. Les fournisseurs du sous-Atlas (INSEE, Statistique Canada…) y figurent aussi, bien que leurs indicateurs n'entrent pas dans le catalogue sous leur propre clé de source.

Erreurs génériques : voir Démarrage. Ne porte jamais de champ de statut de licence (volontaire).

CURL

curl -H "X-API-Key: $ATLAS_KEY" \
  "https://atlasfeed.fr/api/sources"

PYTHON

import requests

r = requests.get(
    "https://atlasfeed.fr/api/sources",
    headers={"X-API-Key": ATLAS_KEY},
)
data = r.json()

JAVASCRIPT

const r = await fetch("https://atlasfeed.fr/api/sources", {
  headers: { "X-API-Key": ATLAS_KEY },
});
const data = await r.json();

RÉPONSE

{
  "sources": [
    {"source": "worldbank", "organization": "World Bank", "url": "https://data.worldbank.org"},
    {"source": "data360", "organization": "World Bank Data360", "url": "https://data360.worldbank.org"},
    {"source": "owid", "organization": "Our World in Data", "url": "https://ourworldindata.org"}
  ]
}

GET/api/indicators/explore

Longue traîne complète du catalogue (~3630+ entrées), localisée, pour un panneau « explorer tous les indicateurs » sans requête tapée. La langue suit l'en-tête Accept-Language.

Erreurs génériques : voir Démarrage.

CURL

curl -H "X-API-Key: $ATLAS_KEY" \
  "https://atlasfeed.fr/api/indicators/explore"

PYTHON

import requests

r = requests.get(
    "https://atlasfeed.fr/api/indicators/explore",
    headers={"X-API-Key": ATLAS_KEY},
)
data = r.json()

JAVASCRIPT

const r = await fetch("https://atlasfeed.fr/api/indicators/explore", {
  headers: { "X-API-Key": ATLAS_KEY },
});
const data = await r.json();

RÉPONSE

{
  "results": [
    {
      "code": "DT.ODA.ODAT.CD",
      "label": "Net official development assistance received (current US$)",
      "theme": "World Bank · Finances publiques",
      "unit": "US$ courants",
      "fmt": "currency",
      "headline": false,
      "source": "worldbank",
      "forecastable": true
    }
  ]
}

GET/api/indicators/search

Recherche libre multilingue sur tout le catalogue (curaté + longue traîne).

Paramètre

Type

Requis

Défaut

Description

string

non

Terme de recherche.

limit

int

non

Bornes : 1 à 200.

Code

Erreur

Cas

422

validation

limit hors bornes (1-200) — validation FastAPI/Pydantic native.

Aucune erreur explicite n'est levée pour un q vide ou sans résultat : la réponse est alors une liste vide en 200. Erreurs génériques (401/429) : voir Démarrage.

CURL

curl -H "X-API-Key: $ATLAS_KEY" \
  "https://atlasfeed.fr/api/indicators/search?q=inflation&limit=3"

PYTHON

import requests

r = requests.get(
    "https://atlasfeed.fr/api/indicators/search",
    params={"q": "inflation", "limit": 3},
    headers={"X-API-Key": ATLAS_KEY},
)
data = r.json()

JAVASCRIPT

const url = new URL("https://atlasfeed.fr/api/indicators/search");
url.searchParams.set("q", "inflation");
url.searchParams.set("limit", "3");
const r = await fetch(url, { headers: { "X-API-Key": ATLAS_KEY } });
const data = await r.json();

RÉPONSE

{
  "query": "inflation",
  "results": [
    {"code": "FP.CPI.TOTL.ZG", "label": "Inflation", "theme": "Économie", "unit": "% annuel", "fmt": "percent", "headline": true, "source": "worldbank", "forecastable": true},
    {"code": "FPCPITOTL", "label": "Inflation Rate (Data360)", "theme": "Data360 · Macro Poverty Outlook", "unit": "valeur", "fmt": "number", "headline": false, "source": "data360", "forecastable": true},
    {"code": "FAO_CP_23014", "label": "Food price inflation (Data360)", "theme": "Data360 · Consumer Price Indices", "unit": "valeur", "fmt": "number", "headline": false, "source": "data360", "forecastable": true}
  ]
}

GET/api/catalog/browse

Passthrough paginé sur le catalogue natif d'une source à découverte « live » (sources énumérables sans passer par le catalogue curaté) : data360, owid, banque_de_france.

Paramètre

Type

Requis

Défaut

Description

source

string

oui

—

Une des sources énumérables (voir description).

limit

int

non

200

Bornes : 1 à 2000.

offset

int

non

Bornes : ≥ 0.

Code

Erreur

Cas

404

source inconnue

source absent de la liste des sources énumérables — attention, worldbank est une source réelle du catalogue mais n'est PAS valide ici.

422

validation

limit ou offset hors bornes.

Autres erreurs (401/429) : voir Démarrage.

CURL

curl -H "X-API-Key: $ATLAS_KEY" \
  "https://atlasfeed.fr/api/catalog/browse?source=owid&limit=2"

PYTHON

import requests

r = requests.get(
    "https://atlasfeed.fr/api/catalog/browse",
    params={"source": "owid", "limit": 2},
    headers={"X-API-Key": ATLAS_KEY},
)
data = r.json()

JAVASCRIPT

const url = new URL("https://atlasfeed.fr/api/catalog/browse");
url.searchParams.set("source", "owid");
url.searchParams.set("limit", "2");
const r = await fetch(url, { headers: { "X-API-Key": ATLAS_KEY } });
const data = await r.json();

RÉPONSE

{
  "source": "owid",
  "count": 4374,
  "items": [
    {"code": "above-ground-biomass-in-forest-per-hectare", "label": "Above Ground Biomass In Forest Per Hectare"},
    {"code": "above-or-below-extreme-poverty-line-world-bank", "label": "Above Or Below Extreme Poverty Line World Bank"}
  ]
}

GET/api/indicator/{code}/meta

Description et source officielle World Bank d'un indicateur — texte en anglais, non traduit.

Paramètre

Type

Requis

Défaut

Description

code

string (path)

oui

—

Code d'indicateur.

Code

Erreur

Cas

404

indicateur inconnu

code absent de catalog.BY_CODE.

Autres erreurs (401/429) : voir Démarrage. Si worldbank.indicator_metadata ne renvoie rien, sourceNote et sourceOrganization valent null (pas une erreur).

CURL

curl -H "X-API-Key: $ATLAS_KEY" \
  "https://atlasfeed.fr/api/indicator/NY.GDP.MKTP.CD/meta"

PYTHON

import requests

r = requests.get(
    "https://atlasfeed.fr/api/indicator/NY.GDP.MKTP.CD/meta",
    headers={"X-API-Key": ATLAS_KEY},
)
data = r.json()

JAVASCRIPT

const r = await fetch(
  "https://atlasfeed.fr/api/indicator/NY.GDP.MKTP.CD/meta",
  { headers: { "X-API-Key": ATLAS_KEY } },
);
const data = await r.json();

RÉPONSE

{
  "code": "NY.GDP.MKTP.CD",
  "label": "PIB",
  "theme": "Économie",
  "unit": "US$ courants",
  "fmt": "currency",
  "headline": true,
  "sourceNote": "Gross domestic product is the total income earned through the production of goods and services in an economic territory during an accounting period. […]",
  "sourceOrganization": "Country official statistics, National Statistical Organizations and/or Central Banks;\nNational Accounts data files, Organisation for Economic Co-operation and Development (OECD);\nStaff estimates, World Bank (WB)"
}

Quotas comptés par mois calendaire. Dépassement : réponse 429, jamais de facturation surprise.

CGV CGU Confidentialité Mentions légales