{
"count": 252,
"countries": [
{
"alpha2": "AF",
"alpha3": "AFG",
"numeric": "004",
"name": "Afghanistan",
"flag": "🇦🇫",
"capital": "Kabul",
"continent": "Asia",
"continent_code": "AS",
"currency_code": "AFN",
"calling_code": "+93",
"population": 43844111
},
{
"alpha2": "AX",
"alpha3": "ALA",
"numeric": "248",
"name": "Aland Islands",
"flag": "🇦🇽",
"capital": "Mariehamn",
"continent": "Europe",
"continent_code": "EU",
"currency_code": "EUR",
"calling_code": "+358-18",
"population": 26711
},
{
"alpha2": "AL",
"alpha3": "ALB",
"numeric": "008",
"name": "Albania",
"flag": "🇦🇱",
"capital": "Tirana",
"continent": "Europe",
"continent_code": "EU",
"currency_code": "ALL",
"calling_code": "+355",
"population": 2349580
}
],
"attribution": "Country data from GeoNames (geonames.org), CC BY 4.0. Subdivisions from ISO 3166-2."
}
curl --location --request GET 'https://zylalabs.com/api/15050/countries+api/39818/list+or+search+countries?eu_only=false' --header 'Authorization: Bearer YOUR_API_KEY'
{
"code": "EUR",
"name": "Euro",
"numeric": "978",
"countries": [
{
"alpha2": "AX",
"name": "Aland Islands",
"flag": "🇦🇽"
},
{
"alpha2": "AD",
"name": "Andorra",
"flag": "🇦🇩"
},
{
"alpha2": "AT",
"name": "Austria",
"flag": "🇦🇹"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/15050/countries+api/39819/currency+details+and+the+countries+that+use+it&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"alpha2": "FR",
"alpha3": "FRA",
"numeric": "250",
"name": "France",
"flag": "🇫🇷",
"capital": "Paris",
"continent": "Europe",
"continent_code": "EU",
"currency_code": "EUR",
"calling_code": "+33",
"population": 68720337,
"official_name": "French Republic",
"currency_name": "Euro",
"area_km2": 547030,
"tld": ".fr",
"languages": [
"fr-FR",
"frp",
"br"
],
"neighbours": [
"CH",
"DE",
"BE"
],
"time_zones": [
"Europe/Paris"
],
"eu_member": true,
"eurozone": true,
"postal_code_format": "#####",
"postal_code_regex": "^(\\d{5})$",
"subdivision_count": 124,
"attribution": "Country data from GeoNames (geonames.org), CC BY 4.0. Subdivisions from ISO 3166-2."
}
curl --location --request GET 'https://zylalabs.com/api/15050/countries+api/39820/look+up+one+country&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"country": "US",
"count": 57,
"subdivisions": [
{
"code": "US-AL",
"name": "Alabama",
"type": "State",
"parent": null
},
{
"code": "US-AK",
"name": "Alaska",
"type": "State",
"parent": null
},
{
"code": "US-AS",
"name": "American Samoa",
"type": "Outlying area",
"parent": null
}
]
}
curl --location --request GET 'https://zylalabs.com/api/15050/countries+api/39821/states+provinces+and+regions+of+a+country&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"country": "DE",
"count": 9,
"neighbours": [
{
"alpha2": "CH",
"alpha3": "CHE",
"numeric": "756",
"name": "Switzerland",
"flag": "🇨🇭",
"capital": "Bern",
"continent": "Europe",
"continent_code": "EU",
"currency_code": "CHF",
"calling_code": "+41",
"population": 9092436
},
{
"alpha2": "PL",
"alpha3": "POL",
"numeric": "616",
"name": "Poland",
"flag": "🇵🇱",
"capital": "Warsaw",
"continent": "Europe",
"continent_code": "EU",
"currency_code": "PLN",
"calling_code": "+48",
"population": 36435861
},
{
"alpha2": "NL",
"alpha3": "NLD",
"numeric": "528",
"name": "The Netherlands",
"flag": "🇳🇱",
"capital": "Amsterdam",
"continent": "Europe",
"continent_code": "EU",
"currency_code": "EUR",
"calling_code": "+31",
"population": 18087633
}
],
"attribution": "Country data from GeoNames (geonames.org), CC BY 4.0. Subdivisions from ISO 3166-2."
}
curl --location --request GET 'https://zylalabs.com/api/15050/countries+api/39822/countries+sharing+a+land+border&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el países API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento.
Datos del país por código ISO: capital, moneda, código de llamada, idiomas, zonas horarias, vecinos y subdivisiones
Tabla de países de GeoNames agrupada (CC BY 4.0) y subdivisiones de ISO 3166-2 Las respuestas incluyen la atribución de GeoNames
La población y el área son una instantánea de GeoNames fechada el 2026-11-14
Cada punto final devuelve datos JSON relacionados con los países, incluyendo detalles como la capital, la moneda, el código de marcación, las lenguas, las zonas horarias y los vecinos geográficos. Por ejemplo, el punto final "Buscar un país" proporciona información completa sobre un país específico, mientras que el punto final "Listar o buscar países" devuelve un resumen de múltiples países
Los campos clave incluyen códigos de país (alpha2, alpha3, numérico), nombre, capital, código de moneda, código de llamado, población, idiomas y zonas horarias. Por ejemplo, el punto de acceso "GET Buscar un país" incluye campos como "nombre_oficial" y "área_km2" para obtener información detallada sobre el país
La API proporciona varios tipos de información, como datos demográficos de países (población, área), datos geográficos (vecinos, subdivisiones) y detalles económicos (moneda, códigos de marcación). Cada punto final se centra en aspectos específicos, como el punto final "OBTENER detalles de moneda" que enumera los países que utilizan una moneda en particular
Los datos de respuesta están estructurados en formato JSON, que normalmente contiene un objeto principal con campos relevantes y arreglos anidados para datos relacionados. Por ejemplo, el endpoint "GET Estados provincias y regiones de un país" devuelve un conteo y un arreglo de subdivisiones, cada una con sus propios atributos como código y nombre
Los parámetros varían según el punto final; por ejemplo, el punto final "GET Listar o buscar países" puede aceptar parámetros de consulta para filtrar por nombre o región. Los usuarios pueden personalizar las solicitudes especificando códigos de país o códigos de moneda para recuperar datos específicos
Los usuarios pueden aprovechar los datos devueltos para aplicaciones como la planificación de viajes, recursos educativos o análisis económicos Por ejemplo el endpoint "GET Countries sharing a land border" puede ayudar a identificar países vecinos para estudios geográficos o itinerarios de viaje
La precisión de los datos se mantiene a través de la obtención de fuentes de bases de datos reputables como GeoNames y estándares ISO Actualizaciones y controles regulares aseguran que la información refleje las realidades geopolíticas actuales mejorando la fiabilidad para los usuarios
Los casos de uso típicos incluyen el desarrollo de herramientas educativas la creación de aplicaciones de viajes la realización de investigaciones de mercado y el análisis de tendencias demográficas Los datos completos permiten diversas aplicaciones en varios sectores incluyendo turismo y negocios internacionales