REST Countries API
Toutes les informations sur les pays du monde, en une API gratuite et open source.
REST Countries est une API REST gratuite et open source qui fournit des informations détaillées sur plus de 250 pays et territoires. Pour chaque pays, elle renvoie le nom, la capitale, la population, les devises, les langues, les drapeaux, les frontières, la région et de nombreux autres champs. Elle s'adresse aux développeurs qui ont besoin de remplir des listes déroulantes de pays, d'afficher des drapeaux, de construire des formulaires d'inscription internationaux ou tout projet nécessitant des données de référence géographiques fiables.
Que propose l'API REST Countries ?
Tarifs de l'API REST Countries
Gratuite et open source : aucun coût de licence, aucune facturation à l'usage. Le projet est maintenu par la communauté et financé par des dons (Patreon, PayPal) pour couvrir les coûts d'infrastructure.
Offre gratuite — L'API est entièrement gratuite et ne requiert aucune authentification ni clé. Elle traite plusieurs millions de requêtes par jour. Le code étant open source, il est aussi possible de l'auto-héberger.
Authentification & intégration
Aucune authentification requise : pas de clé API ni de jeton. Les requêtes sont publiques et directes.
API REST synchrone, réponses au format JSON. Le filtrage de champs est possible (jusqu'à 10 champs par requête) pour alléger les réponses. La version 3.1 est stable et prête pour la production ; une version 4 est en préversion.
Cas d'usage de l'API REST Countries
- Remplir une liste déroulante de pays dans un formulaire d'inscription.
- Afficher le drapeau, la capitale et la population d'un pays sur une fiche.
- Construire un sélecteur de devise ou de langue par pays.
- Récupérer les pays frontaliers d'un pays donné pour une carte ou un filtre.
- Alimenter une base de référence géographique (régions, sous-régions, codes ISO).
- Localiser une interface en récupérant les traductions des noms de pays.
✓ Points forts
- Entièrement gratuite, sans clé API ni authentification.
- Open source et auto-hébergeable pour un contrôle total.
- Données riches : drapeaux, devises, langues, frontières, codes ISO, traductions.
- Filtrage de champs pour des réponses légères et rapides.
- Nombreux endpoints de recherche (nom, code, devise, langue, région).
⚠ Limites
- Projet communautaire financé par dons : pas de garantie de disponibilité ni de SLA.
- Pour /all, les champs doivent être spécifiés, ce qui impose d'adapter les requêtes.
- Limité aux données de référence sur les pays, sans données démographiques détaillées ni séries temporelles.
- Le rythme de mise à jour dépend de la maintenance bénévole du projet.
Questions fréquentes sur l'API REST Countries
REST Countries est-elle gratuite ?
Oui, l'API est entièrement gratuite et open source, sans frais de licence ni facturation à l'usage. Le projet est financé par des dons pour couvrir l'infrastructure.
Faut-il une clé API pour l'utiliser ?
Non, aucune authentification n'est requise : ni clé API ni jeton. Les requêtes sont publiques et peuvent être appelées directement.
Quelles données renvoie l'API pour un pays ?
Le nom, la capitale, la population, les devises, les langues, les drapeaux, les frontières, la région et la sous-région, les codes ISO, les démonymes et les traductions, entre autres.
Comment récupérer les pays d'une région précise ?
En utilisant l'endpoint par région (ex. /region/{region}) ou par sous-région, qui retourne la liste des pays correspondants.
Peut-on limiter les champs renvoyés ?
Oui, le filtrage de champs permet de ne demander que les données utiles (jusqu'à 10 champs par requête), ce qui allège et accélère les réponses. Pour l'endpoint /all, préciser les champs est obligatoire.
Peut-on auto-héberger l'API ?
Oui, le projet étant open source, il est possible de déployer sa propre instance pour un contrôle total et s'affranchir de la disponibilité de l'instance publique.
