/v1/meta
Dataset totals & largest cities
Pruébalo en vivo
10 llamadas gratis al día — sin registro, sin clave API. Pasa por el gateway de oanor.
Funciona. Consigue una clave API y úsala en tu proyecto.
Obtener una clave APIFragmentos de código
curl "https://api.oanor.com/cities-api/v1/meta" \ -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/cities-api/v1/meta", {
headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/cities-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
"https://api.oanor.com/cities-api/v1/meta",
headers={"x-oanor-key": "oanor_test_..."}
)
Respuesta de ejemplo
Una respuesta real de este endpoint, capturada en la última comprobación de estado.
{
"data": {
"total": 33744,
"fields": [
"id",
"name",
"ascii",
"country",
"country_name",
"admin1",
"latitude",
"longitude",
"population",
"timezone",
"elevation_m"
],
"source": "GeoNames (cities with population ≥ 15,000)",
"largest": [
{
"name": "Shanghai",
"country": "CN",
"population": 24874500
},
{
"name": "Beijing",
"country": "CN",
"population": 18960744
},
{
"name": "Shenzhen",
"country": "CN",
"population": 17494398
},
{
"name": "Guangzhou",
"country": "CN",
"population": 16096724
},
{
"name": "Kinshasa",
"country": "CD",
"population": 16000000
}
],
"countries": 244
},
"meta": {
"timestamp": "2026-05-30T23:56:40.126Z",
"request_id": "8104c41e-acc4-478f-bb55-2f036f521847"
},
"status": "ok",
"message": "Meta retrieved",
"success": true
}