¿Qué incluye el registro de una bandera?

Los códigos ISO 3166-1 alfa-2, alfa-3 y numérico, el nombre del país localizado al idioma solicitado, el emoji de la bandera y una URL de bandera SVG autoalojada.

¿Cómo se localizan los nombres?

En tiempo de ejecución desde los datos CLDR de Unicode integrados en la plataforma, así que cualquier etiqueta de idioma como es, de o ja funciona sin tabla de traducción.

¿Puedo enlazar directamente los SVG?

Sí. Los SVG de banderas se sirven desde el almacenamiento propio de este sitio y no requieren clave de API, así que pueden usarse directamente en una etiqueta img.

¿Qué países cubre?

Todas las entradas ISO 3166-1, incluidos los territorios, con filtro por región.

¿Cuánto cuesta una llamada?

1 token en los endpoints de datos. Cargar las imágenes SVG es gratuito.

DatosMANTENIDA1 token / llamada

Country Flags API

Códigos ISO 3166, nombres de país localizados, emoji de bandera y URL de bandera SVG para todos los países

Banderas y datos de identidad de cada país: códigos ISO 3166-1 (alfa-2, alfa-3, numérico), nombre del país localizado, el emoji de la bandera y la URL de la imagen de la bandera en SVG. Filtra por región y localiza los nombres con un solo parámetro de consulta.

Cada llamada necesita la cabecera X-Api-Key. Una clave gratuita incluye 500 tokens al mes, sin tarjeta. 1 token por llamada, así que el plan gratuito cubre unas 500 llamadas al mes.

Start free — 500 tokens / mo →See all plans

Sin tarjeta de créditoAcceso a más de 125 APIsCancela cuando quieras

response.json

{
  "name": "United States",
  "code": "US",
  "alpha3": "USA",
  "numeric": "840",
  "region": "Americas",
  "emoji": "🇺🇸",
  "flag_svg": "https://dataandapis.com/flags/us.svg"
}

Listo para producción: Infraestructura probada en producción con un SLA de disponibilidad del 99,9 %. Límites de uso generosos y respuestas consistentes.
Integración sencilla: REST + JSON estándar. Funciona con cualquier cliente HTTP. Fragmentos de código listos para copiar en 4 lenguajes.
Una clave, más de 125 APIs: Tu suscripción a DataAndAPIs desbloquea todas las APIs de la plataforma: anime, finanzas, deportes y más.

Casos de uso de Country Flags API

Mostrar la bandera correcta junto a un país, prefijo telefónico o selector de idioma.
Convertir entre códigos ISO alfa-2, alfa-3 y numéricos en cadenas de datos.
Mostrar los nombres de país en el idioma del usuario con un solo parámetro.
Filtrar países por región para formularios e informes.

Endpoints de Country Flags API

Todos los endpoints con sus parámetros y una respuesta de ejemplo real.

Definición OpenAPI Espacio de trabajo en Postman

GETGet Flag By Code
GETList Flags

GETGet Flag By Code

https://api-country-flags.dataandapis.com/v1/flags/{code}

Parámetros de ruta

Parámetro	Ejemplo
code	US	Obligatorio

Parámetros de consulta

Parámetro	Ejemplo
lang	fr	Opcional

Petición de ejemplo

curl "https://api-country-flags.dataandapis.com/v1/flags/US?lang=fr" \
  -H "X-Api-Key: YOUR_API_KEY"

Respuesta de ejemplo

{
  "name": "United States",
  "code": "US",
  "alpha3": "USA",
  "numeric": "840",
  "region": "Americas",
  "emoji": "🇺🇸",
  "flag_svg": "https://dataandapis.com/flags/us.svg"
}

GETList Flags

https://api-country-flags.dataandapis.com/v1/flags

Parámetros de consulta

Parámetro	Ejemplo
lang	en	Opcional
region	Europe	Opcional

Petición de ejemplo

curl "https://api-country-flags.dataandapis.com/v1/flags?lang=en&region=Europe" \
  -H "X-Api-Key: YOUR_API_KEY"

Respuesta de ejemplo

{
  "count": 250,
  "countries": [
    {
      "name": "United States",
      "code": "US",
      "alpha3": "USA",
      "numeric": "840",
      "region": "Americas",
      "emoji": "🇺🇸",
      "flag_svg": "https://dataandapis.com/flags/us.svg"
    },
    {
      "name": "United Kingdom",
      "code": "GB",
      "alpha3": "GBR",
      "numeric": "826",
      "region": "Europe",
      "emoji": "🇬🇧",
      "flag_svg": "https://dataandapis.com/flags/gb.svg"
    }
  ]
}

De dónde salen los datos

Fuente: Tabla de referencia ISO 3166-1, nombres CLDR de Unicode y SVG de banderas autoalojados.
Actualización: Datos de referencia estáticos; actualizados con los cambios de ISO.

Una instalación. Todos los endpoints.

No necesitas SDKs propietarios. Funciona con cualquier cliente HTTP. Elige tu lenguaje y pega el código.

3lenguajes

2endpoints

RESTarquitectura

1clave para todas las APIs

Respuestas totalmente tipadas — autocompletado en tu IDE
Sigue la API al día — los nuevos endpoints llegan el mismo día
Una sola clave funciona en más de 125 APIs de la plataforma

import axios from 'axios';

const { data } = await axios.get(
  'https://api-country-flags.dataandapis.com/v1/flags/{code}',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Country Flags API · X-Api-Key

Explora los endpoints

Explora los parámetros de solicitud e inspecciona ejemplos de respuesta en vivo.

Endpoints disponibles

Parámetros de la solicitud

URL de la API

Encabezados

X-Api-Key

Parámetros de consulta

lang(Opcional)

Parámetros de ruta

code

Lenguaje:

Cliente:

import axios from 'axios';

const url = 'https://api-country-flags.dataandapis.com/v1/flags/{code}';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});

Una suscripción. Todas las APIs.

Los tokens desbloquean esta API y más de 20 más en DataAndAPIs. Cambia de API cuando quieras.

GRATIS

$0/mes

500 tokens / mes

Acceso a todas las APIs
Tokens se renuevan mensualmente
Soporte comunitario

Comienza gratis

Más Popular

STARTER

$6.99/mes

25.000 tokens / mes

Acceso a todas las APIs
Tokens se renuevan mensualmente
Soporte por email

PRO

$24.99/mes

100.000 tokens / mes

Acceso a todas las APIs
Tokens se renuevan mensualmente
Soporte por email prioritario

ULTRA

$99.99/mes

1.000.000 tokens / mes

Acceso a todas las APIs
Tokens se renuevan mensualmente
Soporte prioritario

¿Necesitas mayor volumen, infraestructura dedicada o un contrato personalizado? Habla con ventas →

Country Flags API

Casos de uso de Country Flags API

Endpoints de Country Flags API

GETGet Flag By Code

GETList Flags

De dónde salen los datos

Explora los endpoints

Una suscripción. Todas las APIs.

Preguntas sobre Country Flags API

APIs que suelen usarse con Country Flags API

Lanza Country Flags API esta tarde.