Logo
Iniciar sesiónComenzar
Continents, Countries And Cities API
DatosMANTENIDA2 tokens / llamadaPor: hefesto technologies

Continents, Countries And Cities API

252 países, 7 continentes y 235.640 ciudades de GeoNames con coordenadas, población, zona horaria y nombres

Continentes, paises y ciudades — reconstruida sobre GeoNames, la base geografica de referencia mundial: 235.640 ciudades y pueblos (todo lugar con mas de 500 habitantes), 252 paises y los 7 continentes, autoalojado y coherente. Cada ciudad incluye coordenadas reales, poblacion, altitud, zona horaria IANA, region y nombres alternativos (Munich encuentra München); cada pais incluye capital, ISO2/ISO3, superficie, poblacion, moneda, idiomas, TLD, prefijo telefonico y paises vecinos; los continentes agregan sus paises y poblacion. Busque ciudades por prefijo en grafias nativas y ASCII, filtre por pais, region o poblacion minima, y encuentre las ciudades cercanas a una coordenada con el endpoint de proximidad ordenado por distancia. Las integraciones existentes siguen funcionando: se mantienen las rutas clasicas y los parametros name/page/pageSize. Actualizacion diaria desde el feed oficial de GeoNames (CC-BY 4.0, atribucion incluida). Sin llamadas a terceros.

Cada llamada necesita la cabecera X-Api-Key. Una clave gratuita incluye 500 tokens al mes, sin tarjeta. 2 tokens por llamada, así que el plan gratuito cubre unas 250 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
{
  "geonameid": 3674962,
  "name": "Medellín",
  "country": "Colombia",
  "region": "Antioquia",
  "population": 1999979,
  "latitude": 6.245,
  "longitude": -75.57151,
  "timezone": "America/Bogota"
}

Also available on

RapidApi
RapidApi
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 Continents, Countries And Cities API

  • Rellenar selectores de país y ciudad con nombres consistentes, códigos ISO y resultados ordenados por población.

  • Validar una ciudad introducida por el usuario contra una lista mundial, incluidos nombres locales e históricos.

  • Mostrar datos del país como capital, moneda, idiomas, prefijo telefónico y TLD en un perfil.

  • Encontrar ciudades cerca de una coordenada para localizadores de tiendas y zonas de reparto.

Endpoints de Continents, Countries And Cities API

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

GETcities

https://continents-countries-and-cities.dataandapis.com/v1/cities

Parámetros de consulta

ParámetroEjemplo
countryCOOpcional
limit20Opcional
min_population100000Opcional
namemedellinOpcional
page1Opcional
pageSize10Opcional
qMedellOpcional
regionAntioquiaOpcional

Petición de ejemplo

curl "https://continents-countries-and-cities.dataandapis.com/v1/cities?country=CO&limit=20&min_population=100000&name=medellin&page=1&pageSize=10&q=Medell&region=Antioquia" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "total": 7,
  "page": 1,
  "limit": 20,
  "count": 7,
  "attribution": "Data (c) GeoNames (geonames.org), CC-BY 4.0",
  "results": [
    {
      "geonameid": 3674962,
      "name": "Medellín",
      "country_code": "CO",
      "country": "Colombia",
      "region": "Antioquia",
      "population": 1999979,
      "latitude": 6.245,
      "longitude": -75.57151,
      "timezone": "America/Bogota"
    },
    {
      "geonameid": 1699896,
      "name": "Medellin",
      "country_code": "PH",
      "country": "Philippines",
      "region": "Central Visayas",
      "population": 11741,
      "latitude": 11.1286,
      "longitude": 123.9622,
      "timezone": "Asia/Manila"
…
Ver la respuesta completa
{
  "total": 7,
  "page": 1,
  "limit": 20,
  "count": 7,
  "attribution": "Data (c) GeoNames (geonames.org), CC-BY 4.0",
  "results": [
    {
      "geonameid": 3674962,
      "name": "Medellín",
      "country_code": "CO",
      "country": "Colombia",
      "region": "Antioquia",
      "population": 1999979,
      "latitude": 6.245,
      "longitude": -75.57151,
      "timezone": "America/Bogota"
    },
    {
      "geonameid": 1699896,
      "name": "Medellin",
      "country_code": "PH",
      "country": "Philippines",
      "region": "Central Visayas",
      "population": 11741,
      "latitude": 11.1286,
      "longitude": 123.9622,
      "timezone": "Asia/Manila"
    },
    {
      "geonameid": 3802417,
      "name": "Medellín y Madero Segunda Sección",
      "country_code": "MX",
      "country": "Mexico",
      "region": "Tabasco",
      "population": 7825,
      "latitude": 18.11351,
      "longitude": -92.854,
      "timezone": "America/Mexico_City"
    },
    {
      "geonameid": 3523387,
      "name": "Medellín de Bravo",
      "country_code": "MX",
      "country": "Mexico",
      "region": "Veracruz",
      "population": 2725,
      "latitude": 19.05869,
      "longitude": -96.15781,
      "timezone": "America/Mexico_City"
    },
    {
      "geonameid": 2513968,
      "name": "Medellín",
      "country_code": "ES",
      "country": "Spain",
      "region": "Extremadura",
      "population": 2357,
      "latitude": 38.96265,
      "longitude": -5.95785,
      "timezone": "Europe/Madrid"
    },
    {
      "geonameid": 8862302,
      "name": "Medellín",
      "country_code": "MX",
      "country": "Mexico",
      "region": "Veracruz",
      "population": 584,
      "latitude": 18.41639,
      "longitude": -95.36611,
      "timezone": "America/Mexico_City"
    },
    {
      "geonameid": 3802441,
      "name": "Medellín y Pigua 1ra. Sección",
      "country_code": "MX",
      "country": "Mexico",
      "region": "Tabasco",
      "population": 529,
      "latitude": 18.02917,
      "longitude": -92.91278,
      "timezone": "America/Mexico_City"
    }
  ]
}

GETcontinents

https://continents-countries-and-cities.dataandapis.com/v1/continents

Parámetros de consulta

ParámetroEjemplo
nameNorth AmericaOpcional
page1Opcional
pageSize10Opcional

Petición de ejemplo

curl "https://continents-countries-and-cities.dataandapis.com/v1/continents?name=North%20America&page=1&pageSize=10" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "count": 7,
  "attribution": "Data (c) GeoNames (geonames.org), CC-BY 4.0",
  "results": [
    {
      "code": "AF",
      "name": "Africa",
      "geonameid": 6255146,
      "countries": 58,
      "population": 1277404803
    },
    {
      "code": "AN",
      "name": "Antarctica",
      "geonameid": 6255152,
      "countries": 5,
      "population": 170
    },
    {
      "code": "AS",
      "name": "Asia",
      "geonameid": 6255147,
      "countries": 51,
      "population": 4542820771
    },
    {
      "code": "EU",
      "name": "Europe",
…
Ver la respuesta completa
{
  "count": 7,
  "attribution": "Data (c) GeoNames (geonames.org), CC-BY 4.0",
  "results": [
    {
      "code": "AF",
      "name": "Africa",
      "geonameid": 6255146,
      "countries": 58,
      "population": 1277404803
    },
    {
      "code": "AN",
      "name": "Antarctica",
      "geonameid": 6255152,
      "countries": 5,
      "population": 170
    },
    {
      "code": "AS",
      "name": "Asia",
      "geonameid": 6255147,
      "countries": 51,
      "population": 4542820771
    },
    {
      "code": "EU",
      "name": "Europe",
      "geonameid": 6255148,
      "countries": 54,
      "population": 753757455
    },
    {
      "code": "NA",
      "name": "North America",
      "geonameid": 6255149,
      "countries": 42,
      "population": 583536773
    },
    {
      "code": "OC",
      "name": "Oceania",
      "geonameid": 6255151,
      "countries": 28,
      "population": 43093797
    },
    {
      "code": "SA",
      "name": "South America",
      "geonameid": 6255150,
      "countries": 14,
      "population": 423597139
    }
  ]
}

GETcountries

https://continents-countries-and-cities.dataandapis.com/v1/countries

Parámetros de consulta

ParámetroEjemplo
continentSAOpcional
currencyEUROpcional
languageesOpcional
limit50Opcional
nameNorth AmericaOpcional
page1Opcional
pageSize10Opcional
qswitzerlandOpcional

Petición de ejemplo

curl "https://continents-countries-and-cities.dataandapis.com/v1/countries?continent=SA&currency=EUR&language=es&limit=50&name=North%20America&page=1&pageSize=10&q=switzerland" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "total": 14,
  "page": 1,
  "limit": 3,
  "count": 3,
  "attribution": "Data (c) GeoNames (geonames.org), CC-BY 4.0",
  "results": [
    {
      "iso2": "BR",
      "iso3": "BRA",
      "name": "Brazil",
      "capital": "Brasilia",
      "continent": "SA",
      "area_km2": 8511965,
      "population": 209469333,
      "currency_code": "BRL",
      "currency_name": "Real",
      "languages": "pt-BR,es,en,fr",
      "tld": ".br",
      "phone_prefix": "55",
      "neighbours": "SR,PE,BO,UY,GY,PY,GF,VE,CO,AR",
      "geonameid": 3469034
    },
    {
      "iso2": "CO",
      "iso3": "COL",
      "name": "Colombia",
      "capital": "Bogota",
…
Ver la respuesta completa
{
  "total": 14,
  "page": 1,
  "limit": 3,
  "count": 3,
  "attribution": "Data (c) GeoNames (geonames.org), CC-BY 4.0",
  "results": [
    {
      "iso2": "BR",
      "iso3": "BRA",
      "name": "Brazil",
      "capital": "Brasilia",
      "continent": "SA",
      "area_km2": 8511965,
      "population": 209469333,
      "currency_code": "BRL",
      "currency_name": "Real",
      "languages": "pt-BR,es,en,fr",
      "tld": ".br",
      "phone_prefix": "55",
      "neighbours": "SR,PE,BO,UY,GY,PY,GF,VE,CO,AR",
      "geonameid": 3469034
    },
    {
      "iso2": "CO",
      "iso3": "COL",
      "name": "Colombia",
      "capital": "Bogota",
      "continent": "SA",
      "area_km2": 1138910,
      "population": 49648685,
      "currency_code": "COP",
      "currency_name": "Peso",
      "languages": "es-CO",
      "tld": ".co",
      "phone_prefix": "57",
      "neighbours": "EC,PE,PA,BR,VE",
      "geonameid": 3686110
    },
    {
      "iso2": "AR",
      "iso3": "ARG",
      "name": "Argentina",
      "capital": "Buenos Aires",
      "continent": "SA",
      "area_km2": 2766890,
      "population": 44494502,
      "currency_code": "ARS",
      "currency_name": "Peso",
      "languages": "es-AR,en,it,de,fr,gn",
      "tld": ".ar",
      "phone_prefix": "54",
      "neighbours": "CL,BO,UY,PY,BR",
      "geonameid": 3865483
    }
  ]
}

GETdata sources

https://continents-countries-and-cities.dataandapis.com/v1/sources

Este endpoint no recibe parámetros.

Petición de ejemplo

curl "https://continents-countries-and-cities.dataandapis.com/v1/sources" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "count": 2,
  "sources": [
    {
      "slug": "geonames-cities500",
      "name": "GeoNames cities500 (population >= 500)",
      "publisher": "GeoNames (geonames.org)",
      "licence": "CC-BY 4.0 - attribution required",
      "source_url": "https://www.geonames.org/",
      "file_url": "https://download.geonames.org/export/dump/cities500.zip",
      "cadence": "daily modifications",
      "record_count": 235640,
      "retrieved_at": "2026-09-02"
    },
    {
      "slug": "geonames-countryinfo",
      "name": "GeoNames country information",
      "publisher": "GeoNames (geonames.org)",
      "licence": "CC-BY 4.0 - attribution required",
      "source_url": "https://www.geonames.org/",
      "file_url": "https://download.geonames.org/export/dump/countryInfo.txt",
      "cadence": "daily",
      "record_count": 252,
      "retrieved_at": "2026-09-02"
    }
  ]
}

GETget city by id

https://continents-countries-and-cities.dataandapis.com/v1/cities/{id}

Parámetros de ruta

ParámetroEjemplo
id1796236Obligatorio

Petición de ejemplo

curl "https://continents-countries-and-cities.dataandapis.com/v1/cities/1796236" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "geonameid": 3674962,
  "name": "Medellín",
  "country_code": "CO",
  "country": "Colombia",
  "region": "Antioquia",
  "population": 1999979,
  "latitude": 6.245,
  "longitude": -75.57151,
  "timezone": "America/Bogota",
  "ascii_name": "Medellin",
  "admin1_code": "02",
  "elevation_m": 1405,
  "is_capital": false,
  "feature_code": "PPLA",
  "alternate_names": [
    "MDE",
    "Medegin",
    "Medehl'in",
    "Medel'in",
    "Medelim",
    "Medelin",
    "Medeljina",
    "Medeljinas",
    "Medeljino",
    "Medellin",
    "Medellín",
    "mai de lin",
…
Ver la respuesta completa
{
  "geonameid": 3674962,
  "name": "Medellín",
  "country_code": "CO",
  "country": "Colombia",
  "region": "Antioquia",
  "population": 1999979,
  "latitude": 6.245,
  "longitude": -75.57151,
  "timezone": "America/Bogota",
  "ascii_name": "Medellin",
  "admin1_code": "02",
  "elevation_m": 1405,
  "is_capital": false,
  "feature_code": "PPLA",
  "alternate_names": [
    "MDE",
    "Medegin",
    "Medehl'in",
    "Medel'in",
    "Medelim",
    "Medelin",
    "Medeljina",
    "Medeljinas",
    "Medeljino",
    "Medellin",
    "Medellín",
    "mai de lin",
    "mdlyn",
    "mdyyn",
    "me de yin",
    "medein",
    "medejin",
    "medelini",
    "medellina",
    "medeyina"
  ],
  "modified": "2026-04-13",
  "source": "Data (c) GeoNames (geonames.org), CC-BY 4.0"
}

GETget continent by id

https://continents-countries-and-cities.dataandapis.com/v1/continents/{id}

Parámetros de ruta

ParámetroEjemplo
id1Obligatorio

Petición de ejemplo

curl "https://continents-countries-and-cities.dataandapis.com/v1/continents/1" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "code": "EU",
  "name": "Europe",
  "geonameid": 6255148,
  "countries": [
    {
      "iso2": "RU",
      "name": "Russia",
      "capital": "Moscow",
      "population": 144478050,
      "currency_code": "RUB"
    },
    {
      "iso2": "DE",
      "name": "Germany",
      "capital": "Berlin",
      "population": 82927922,
      "currency_code": "EUR"
    },
    {
      "iso2": "FR",
      "name": "France",
      "capital": "Paris",
      "population": 66987244,
      "currency_code": "EUR"
    },
    {
      "iso2": "GB",
…
Ver la respuesta completa
{
  "code": "EU",
  "name": "Europe",
  "geonameid": 6255148,
  "countries": [
    {
      "iso2": "RU",
      "name": "Russia",
      "capital": "Moscow",
      "population": 144478050,
      "currency_code": "RUB"
    },
    {
      "iso2": "DE",
      "name": "Germany",
      "capital": "Berlin",
      "population": 82927922,
      "currency_code": "EUR"
    },
    {
      "iso2": "FR",
      "name": "France",
      "capital": "Paris",
      "population": 66987244,
      "currency_code": "EUR"
    },
    {
      "iso2": "GB",
      "name": "United Kingdom",
      "capital": "London",
      "population": 66488991,
      "currency_code": "GBP"
    },
    {
      "iso2": "IT",
      "name": "Italy",
      "capital": "Rome",
      "population": 60431283,
      "currency_code": "EUR"
    }
  ],
  "source": "Data (c) GeoNames (geonames.org), CC-BY 4.0"
}

GETget country by id

https://continents-countries-and-cities.dataandapis.com/v1/countries/{id}

Parámetros de ruta

ParámetroEjemplo
id1Obligatorio

Petición de ejemplo

curl "https://continents-countries-and-cities.dataandapis.com/v1/countries/1" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "iso2": "CH",
  "iso3": "CHE",
  "name": "Switzerland",
  "capital": "Bern",
  "continent": "EU",
  "area_km2": 41290,
  "population": 8516543,
  "currency_code": "CHF",
  "currency_name": "Franc",
  "languages": "de-CH,fr-CH,it-CH,rm",
  "tld": ".ch",
  "phone_prefix": "41",
  "neighbours": "DE,IT,LI,FR,AT",
  "geonameid": 2658434,
  "top_cities": [
    {
      "geonameid": 2657896,
      "name": "Zürich",
      "region": "Zurich",
      "population": 415367,
      "feature_code": "PPLA",
      "is_capital": false
    },
    {
      "geonameid": 2660646,
      "name": "Geneva",
      "region": "Geneva",
…
Ver la respuesta completa
{
  "iso2": "CH",
  "iso3": "CHE",
  "name": "Switzerland",
  "capital": "Bern",
  "continent": "EU",
  "area_km2": 41290,
  "population": 8516543,
  "currency_code": "CHF",
  "currency_name": "Franc",
  "languages": "de-CH,fr-CH,it-CH,rm",
  "tld": ".ch",
  "phone_prefix": "41",
  "neighbours": "DE,IT,LI,FR,AT",
  "geonameid": 2658434,
  "top_cities": [
    {
      "geonameid": 2657896,
      "name": "Zürich",
      "region": "Zurich",
      "population": 415367,
      "feature_code": "PPLA",
      "is_capital": false
    },
    {
      "geonameid": 2660646,
      "name": "Geneva",
      "region": "Geneva",
      "population": 201741,
      "feature_code": "PPLA",
      "is_capital": false
    },
    {
      "geonameid": 2661604,
      "name": "Basel",
      "region": "Basel-City",
      "population": 177595,
      "feature_code": "PPLA",
      "is_capital": false
    },
    {
      "geonameid": 2659994,
      "name": "Lausanne",
      "region": "Vaud",
      "population": 139111,
      "feature_code": "PPLA",
      "is_capital": false
    }
  ],
  "source": "Data (c) GeoNames (geonames.org), CC-BY 4.0"
}

GETnearby cities

https://continents-countries-and-cities.dataandapis.com/v1/cities/nearby

Parámetros de consulta

ParámetroEjemplo
lat51.51Opcional
limit20Opcional
lon-0.13Opcional
radius25Opcional

Petición de ejemplo

curl "https://continents-countries-and-cities.dataandapis.com/v1/cities/nearby?lat=51.51&limit=20&lon=-0.13&radius=25" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "lat": 51.51,
  "lon": -0.13,
  "radius_km": 15,
  "count": 3,
  "attribution": "Data (c) GeoNames (geonames.org), CC-BY 4.0",
  "results": [
    {
      "geonameid": 2643743,
      "name": "London",
      "country_code": "GB",
      "country": "United Kingdom",
      "region": "England",
      "population": 8961989,
      "latitude": 51.50853,
      "longitude": -0.12574,
      "timezone": "Europe/London",
      "distance_km": 0.3
    },
    {
      "geonameid": 6545173,
      "name": "Soho",
      "country_code": "GB",
      "country": "United Kingdom",
      "region": "England",
      "population": 19634,
      "latitude": 51.5144,
      "longitude": -0.13535,
…
Ver la respuesta completa
{
  "lat": 51.51,
  "lon": -0.13,
  "radius_km": 15,
  "count": 3,
  "attribution": "Data (c) GeoNames (geonames.org), CC-BY 4.0",
  "results": [
    {
      "geonameid": 2643743,
      "name": "London",
      "country_code": "GB",
      "country": "United Kingdom",
      "region": "England",
      "population": 8961989,
      "latitude": 51.50853,
      "longitude": -0.12574,
      "timezone": "Europe/London",
      "distance_km": 0.3
    },
    {
      "geonameid": 6545173,
      "name": "Soho",
      "country_code": "GB",
      "country": "United Kingdom",
      "region": "England",
      "population": 19634,
      "latitude": 51.5144,
      "longitude": -0.13535,
      "timezone": "Europe/London",
      "distance_km": 0.6
    },
    {
      "geonameid": 6615507,
      "name": "St James's",
      "country_code": "GB",
      "country": "United Kingdom",
      "region": "England",
      "population": 10361,
      "latitude": 51.5073,
      "longitude": -0.13982,
      "timezone": "Europe/London",
      "distance_km": 0.7
    }
  ]
}

De dónde salen los datos

Fuente
GeoNames (CC BY 4.0): cities500, información de países y datos de continentes.
Actualización
Sincronización diaria de las modificaciones de GeoNames.

Una instalación. Todos los endpoints.

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

3lenguajes
8endpoints
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://continents-countries-and-cities.dataandapis.com/v1/cities',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Continents, Countries And Cities 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

country(Opcional)
limit(Opcional)
min_population(Opcional)
name(Opcional)
page(Opcional)
pageSize(Opcional)
q(Opcional)
region(Opcional)
import axios from 'axios';

const url = 'https://continents-countries-and-cities.dataandapis.com/v1/cities';
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
Suscribirse

PRO

$24.99/mes

100.000 tokens / mes

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

ULTRA

$99.99/mes

1.000.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte prioritario
Suscribirse

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

Preguntas sobre Continents, Countries And Cities API

APIs que suelen usarse con Continents, Countries And Cities API

Lanza Continents, Countries And Cities API esta tarde.

500 tokens gratis. Sin tarjeta. Y más de 125 APIs más con la misma clave.

Obtén tu clave API →Explorar todas las APIs