API en ligne · Fair use

Une Country API
gratuite avec drapeaux, indicatifs & plus.

Endpoints JSON rapides pour les données pays — drapeaux, blasons, langues, monnaies, indicatifs et codes ISO. Fournie par Nexperts BV.

245
Pays
19
Endpoints
€0
Coût
JSON
Format
nl de fr gb us jp br za au ca in mx
Démarrage rapide

Démarrez en
une seule requête.

Pas de clé API, pas d'inscription. Effectuez une requête GET et obtenez immédiatement un JSON avec tout ce qu'il faut savoir sur un pays.

Sans auth Compatible CORS En cache UTF-8
$ curl https://countries.nexperts.nl/nl
↳ retourne du JSON avec name, flags, currencies, languages, callingcode, …
Référence

Tous les endpoints

Méthode Endpoint Description Essayer
GET /{code} Pays par code ISO 3166-1 Alpha-2 (par ex. NL, de). Insensible à la casse. /nl
GET /countries Liste complète des codes ISO 3166-1 Alpha-2 valides. /countries
GET /countrycode/{code} Lookup direct dans le cache (saute la validation et l'appel upstream). /countrycode/nl
GET /name/{name} Recherche par nom de pays (min. 3 lettres, espaces avec _). /name/united_kingdom
GET /callingcode/{number} Lookup par indicatif téléphonique international (par ex. 31, 49). /callingcode/49
GET /cca3/{code} Lookup par code ISO 3166-1 Alpha-3 (par ex. NLD, deu). /cca3/nld
GET /region/{name} Tous les pays d'une région : europe, asia, africa, americas, oceania, antarctic. /region/europe
GET /subregion/{name} Tous les pays d'une sous-région (par ex. western_europe, south-eastern_asia). /subregion/western_europe
GET /currency/{code} Tous les pays utilisant cette monnaie (par ex. EUR, USD). /currency/eur
GET /language/{code} Tous les pays où cette langue est parlée (ISO 639-3, par ex. nld, fra, eng). /language/nld
GET /capital/{name} Recherche par capitale (correspondance partielle, min. 3 lettres). Supporte les pays avec plusieurs capitales. /capital/amsterdam
GET /border/{code} Pays voisins (cca2). Tableau vide si le pays n'a pas de frontières terrestres. /border/nl
GET /timezone/{offset} Pays dans un fuseau horaire. Format +0100, -0500, +0530 (préfixe UTC facultatif). /timezone/+0100
GET /independent Tous les pays indépendants. /independent
GET /un-members Tous les États membres de l'ONU. /un-members
GET /landlocked Tous les pays sans accès à la mer. /landlocked
GET /random Un pays aléatoire — pratique pour les démos et les quiz. /random
GET /flags/{file} Image du drapeau (.png ou .svg). /flags/nl.svg
GET /coa/{file} Blason (.png ou .svg). /coa/nl.svg
Exemples

Essayez maintenant

Avec curl
$ curl https://countries.nexperts.nl/nl
$ curl https://countries.nexperts.nl/name/united_kingdom
$ curl https://countries.nexperts.nl/callingcode/49
Avec JavaScript
const res = await fetch('https://countries.nexperts.nl/nl');
const [country] = await res.json();
console.log(country.name.common); // "Netherlands"
Réponse

Exemple de réponse JSON

Un GET sur /nl retourne un tableau avec un objet pays qui ressemble à ceci (tronqué) :

GET https://countries.nexperts.nl/nl
[
  {
    "name": {
      "common": "Netherlands",
      "official": "Kingdom of the Netherlands"
    },
    "cca2": "NL",
    "cca3": "NLD",
    "capital": ["Amsterdam"],
    "region": "Europe",
    "languages": { "nld": "Dutch" },
    "currencies": {
      "EUR": { "name": "Euro", "symbol": "€" }
    },
    "idd": { "root": "+3", "suffixes": ["1"] },
    "population": 16655799,
    "flag": "🇳🇱",
    "flags": {
      "png": "https://countries.nexperts.nl/flags/nl.png",
      "svg": "https://countries.nexperts.nl/flags/nl.svg"
    },
    "coatOfArms": {
      "png": "https://countries.nexperts.nl/coa/nl.png",
      "svg": "https://countries.nexperts.nl/coa/nl.svg"
    },
    "timezones": ["UTC+01:00"],
    "continents": ["Europe"]
  }
]
Fair use

Pas de rate limit, mais utilisez-la avec discernement. Mettez en cache les résultats côté client si possible.

En cache local

Toutes les données, drapeaux et blasons sont servis localement pour des temps de réponse rapides.

Sans garantie

Disponibilité best-effort. Pour une production avec SLA — contactez Nexperts pour une configuration dédiée.