This API provides robust and detailed access to geographic and administrative information related to countries and their territorial subdivisions. Using a first endpoint, it is possible to query countries by name, obtaining key data such as the official name, along with the standard ISO alpha-2 and alpha-3 codes, which are widely used in international systems to uniquely and consistently identify countries. This facilitates integration with other systems that require uniform and accurate country identification data.
Additionally, the second endpoint allows you to obtain much more detailed and localized information at the level of administrative subdivisions within a country. From the country name, you can access lists of regions, cities, counties, or boroughs, with accurate data including unique identifiers (id and geoname_id), official and alternative names, administrative codes of different levels (admin1_code, admin2_code, etc.), as well as demographic data such as the population of each locality. Specific geographic information such as the latitude and longitude of each location is also included, along with the corresponding time zone, which is essential for applications that require synchronization or exact time localization.
In summary, this API is a comprehensive tool for accessing standardized and up-to-date geographic, administrative, and demographic data, allowing for both a macro approach at the country level and a more granular analysis at the territorial subdivision level, facilitating multiple use cases in different sectors.
To use this endpoint, you must specify the name of a country in the parameter.
Country ISO - Características del Endpoint
| Objeto | Descripción |
|---|---|
name |
[Requerido] Indicates a country name |
{"countries":[{"name":"United States","alpha3_code":"USA","alpha2_code":"US"},{"name":"United States Minor Outlying Islands","alpha3_code":"UMI","alpha2_code":"UM"}]}
curl --location --request GET 'https://zylalabs.com/api/7196/city+region+information+api/11335/country+iso?name=United States' --header 'Authorization: Bearer YOUR_API_KEY'
To use this endpoint, you must specify the name of a city in the parameter.
City Information - Características del Endpoint
| Objeto | Descripción |
|---|---|
name |
[Requerido] Indicates a city |
{"cities":[{"id":4245,"geoname_id":2950096,"name":"Bernau bei Berlin","ascii_name":"Bernau bei Berlin","alternate_names":"Bernau,Bernau baj Berlin,Bernau kaj Berlin,Bernava pie Berlines,Bernava pie Berlīnes,Bernoa,bai lin fu jin bei er nao,brna bay brlyn,Бернау,Бернау бај Берлин,Бернау кај Берлин,Բերնաու,ברנאו שליד ברלין,برنا بای برلین,柏林附近贝尔瑙","country_code":"DE","country_name":"Germany","admin1_code":"11","admin2_code":"00","admin3_code":"12060","admin4_code":"12060020","population":34866,"elevation":null,"timezone":"Europe/Berlin","latitude":52.67982,"longitude":13.58708},{"id":9054,"geoname_id":7290255,"name":"Berlin Treptow","ascii_name":"Berlin Treptow","alternate_names":"Treptow","country_code":"DE","country_name":"Germany","admin1_code":"16","admin2_code":"00","admin3_code":"11000","admin4_code":"11000000","population":50000,"elevation":null,"timezone":"Europe/Berlin","latitude":52.49376,"longitude":13.44469},{"id":14945,"geoname_id":5245497,"name":"Berlin","ascii_name":"Berlin","alternate_names":"Berlin,Strongs Landing,Strongville,berlini,brln wskwnsn,brlyn,brlyn wyskansyn,Берлин,برلن، وسکونسن,برلين,برلین، ویسکانسین,ბერლინი","country_code":"US","country_name":"United States","admin1_code":"WI","admin2_code":"047","admin3_code":"06925","admin4_code":null,"population":5420,"elevation":246.0,"timezone":"America/Chicago","latitude":43.96804,"longitude":-88.94345},{"id":31050,"geoname_id":2950159,"name":"Berlin","ascii_name":"Berlin","alternate_names":"BER,Beirlin,Beirlín,Belin,Berleno,Berlien,Berliin,Berliini,Berlijn,Berlim,Berlin,Berline,Berlini,Berlino,Berlyn,Berlynas,Berlëno,Berlín,Berlîn,Berlīne,Berolino,Berolinum,Birlinu,Bèrlîn,Estat de Berlin,Estat de Berlín,bai lin,barlina,beleullin,berlini,berurin,bexrlin,brlyn,perlin,Βερολίνο,Берлин,Берлін,Бэрлін,Բերլին,בערלין,ברלין,برلين,برلین,بېرلىن,ܒܪܠܝܢ,बर्लिन,বার্লিন,பெர்லின்,เบอร์ลิน,ბერლინი,ベルリン,柏林,베를린","country_code":"DE","country_name":"Germany","admin1_code":"16","admin2_code":"00","admin3_code":"11000","admin4_code":"11000000","population":3426354,"elevation":74.0,"timezone":"Europe/Berlin","latitude":52.52437,"longitude":13.41053},{"id":32463,"geoname_id":4393581,"name":"Kimberling City","ascii_name":"Kimberling City","alternate_names":null,"country_code":"US","country_name":"United States","admin1_code":"MO","admin2_code":"209","admin3_code":"63763","admin4_code":null,"population":2313,"elevation":290.0,"timezone":"America/Chicago","latitude":36.6334,"longitude":-93.41685},{"id":32735,"geoname_id":5165445,"name":"Oberlin","ascii_name":"Oberlin","alternate_names":"Oberle,Oberlin,awbrlyn,awbrlyn awhayw,Оберле,Оберлин,Оберлін,أوبرلين,اوبرلین، اوهایو","country_code":"US","country_name":"United States","admin1_code":"OH","admin2_code":"093","admin3_code":"57834","admin4_code":null,"population":8350,"elevation":248.0,"timezone":"America/New_York","latitude":41.29394,"longitude":-82.21738},{"id":38750,"geoname_id":2950139,"name":"Berlingerode","ascii_name":"Berlingerode","alternate_names":"Berlingerode","country_code":"DE","country_name":"Germany","admin1_code":"15","admin2_code":"00","admin3_code":"16061","admin4_code":"16061003","population":1248,"elevation":null,"timezone":"Europe/Berlin","latitude":51.45775,"longitude":10.2384},{"id":41633,"geoname_id":5203105,"name":"New Berlinville","ascii_name":"New Berlinville","alternate_names":null,"country_code":"US","country_name":"United States","admin1_code":"PA","admin2_code":"011","admin3_code":"14984","admin4_code":null,"population":1368,"elevation":119.0,"timezone":"America/New_York","latitude":40.34537,"longitude":-75.63296},{"id":57032,"geoname_id":1019883,"name":"Berlin","ascii_name":"Berlin","alternate_names":"Berlin","country_code":"ZA","country_name":"South Africa","admin1_code":"05","admin2_code":"BUF","admin3_code":"BUF","admin4_code":null,"population":3650,"elevation":null,"timezone":"Africa/Johannesburg","latitude":-32.88309,"longitude":27.58122},{"id":64526,"geoname_id":4335887,"name":"Oberlin","ascii_name":"Oberlin","alternate_names":null,"country_code":"US","country_name":"United States","admin1_code":"LA","admin2_code":"003","admin3_code":null,"admin4_code":null,"population":1752,"elevation":22.0,"timezone":"America/Chicago","latitude":30.6202,"longitude":-92.76265},{"id":64904,"geoname_id":5264381,"name":"New Berlin","ascii_name":"New Berlin","alternate_names":"Mentor,Naujasis Berlynas,New Berlin,Nju Berlin,brlyn jdyd wyskansyn,nyw brln wskwnsn,nyw brlyn,Њу Берлин,برلین جدید، ویسکانسین,نيو برلين,نیو برلن، وسکونسن","country_code":"US","country_name":"United States","admin1_code":"WI","admin2_code":"133","admin3_code":"56375","admin4_code":null,"population":39825,"elevation":281.0,"timezone":"America/Chicago","latitude":42.9764,"longitude":-88.10842},{"id":80487,"geoname_id":3182154,"name":"Berlingo","ascii_name":"Berlingo","alternate_names":"Berlingo,beruringo,ベルリンゴ","country_code":"IT","country_name":"Italy","admin1_code":"09","admin2_code":"BS","admin3_code":"017015","admin4_code":null,"population":1656,"elevation":121.0,"timezone":"Europe/Rome","latitude":45.50281,"longitude":10.03436},{"id":83001,"geoname_id":4557666,"name":"East Berlin","ascii_name":"East Berlin","alternate_names":"Berlin,East Berlin","country_code":"US","country_name":"United States","admin1_code":"PA","admin2_code":"001","admin3_code":"20792","admin4_code":null,"population":1534,"elevation":131.0,"timezone":"America/New_York","latitude":39.9376,"longitude":-76.97859},{"id":101797,"geoname_id":4930431,"name":"Berlin","ascii_name":"Berlin","alternate_names":"Berlin,Berlin Centre,brlyn masachwst,Берлин,برلن، میساچوسٹس,برلین، ماساچوست","country_code":"US","country_name":"United States","admin1_code":"MA","admin2_code":"027","admin3_code":"05490","admin4_code":null,"population":2422,"elevation":100.0,"timezone":"America/New_York","latitude":42.3812,"longitude":-71.63701},{"id":108547,"geoname_id":2885657,"name":"Berlin Köpenick","ascii_name":"Berlin Koepenick","alternate_names":"Berlin-Kopenick,Berlin-Köpenick,Koepenick,Köpenick","country_code":"DE","country_name":"Germany","admin1_code":"16","admin2_code":"00","admin3_code":"11000","admin4_code":"11000000","population":59561,"elevation":null,"timezone":"Europe/Berlin","latitude":52.44254,"longitude":13.58228},{"id":109594,"geoname_id":2820577,"name":"Überlingen","ascii_name":"Uberlingen","alternate_names":"Iberlingen,Juberlingen,UEberlingen,Uberlingen,abyrlngyn,awbrlyngn,iuberlingeni,yu bei er lin gen,Überlingen,Иберлинген,Юберлинген,Юберлінген,Իբերլինգեն,ابیرلنگین,اوبرلینگن,იუბერლინგენი,于贝尔林根","country_code":"DE","country_name":"Germany","admin1_code":"01","admin2_code":"084","admin3_code":"08435","admin4_code":"08435059","population":21507,"elevation":null,"timezone":"Europe/Berlin","latitude":47.76977,"longitude":9.17136},{"id":110174,"geoname_id":4556518,"name":"Berlin","ascii_name":"Berlin","alternate_names":null,"country_code":"US","country_name":"United States","admin1_code":"PA","admin2_code":"111","admin3_code":"05776","admin4_code":null,"population":2019,"elevation":710.0,"timezone":"America/New_York","latitude":39.92064,"longitude":-78.9578},{"id":112097,"geoname_id":4500771,"name":"Berlin","ascii_name":"Berlin","alternate_names":"Berlin,Long-a-coming,Longacoming,Magnolia,brlyn nywjrsy,Берлин,برلین، نیوجرسی","country_code":"US","country_name":"United States","admin1_code":"NJ","admin2_code":"007","admin3_code":"05440","admin4_code":null,"population":7590,"elevation":50.0,"timezone":"America/New_York","latitude":39.79123,"longitude":-74.92905},{"id":115668,"geoname_id":4348460,"name":"Berlin","ascii_name":"Berlin","alternate_names":"Ber Lin,Berlin,Burleigh Manor,Burley,Stephens Cross Roads,Stevensons Crossroads,brlyn,brlyn mrylnd,Берлин,برلن، میری لینڈ,برلين,برلین، مریلند","country_code":"US","country_name":"United States","admin1_code":"MD","admin2_code":"047","admin3_code":null,"admin4_code":null,"population":4529,"elevation":11.0,"timezone":"America/New_York","latitude":38.32262,"longitude":-75.21769},{"id":126661,"geoname_id":5446098,"name":"Oberlin","ascii_name":"Oberlin","alternate_names":"Oberle,Oberlin,Sappa,Westfield,awbrlyn,awbrlyn kanzas,Оберле,أوبرلين,اوبرلین، کانزاس","country_code":"US","country_name":"United States","admin1_code":"KS","admin2_code":"039","admin3_code":"52000","admin4_code":null,"population":1761,"elevation":781.0,"timezone":"America/Chicago","latitude":39.81834,"longitude":-100.5282},{"id":136880,"geoname_id":5083330,"name":"Berlin","ascii_name":"Berlin","alternate_names":"BML,Berlin,Maynesboro,Maynesborough,bai lin,barin,beollin,brlyn,brlyn nywhmpshayr,Берлин,Берлін,برلن، نیو ہیمپشائر,برلين,برلین، نیوهمپشایر,バーリン,柏林,벌린","country_code":"US","country_name":"United States","admin1_code":"NH","admin2_code":"007","admin3_code":"05140","admin4_code":null,"population":9367,"elevation":311.0,"timezone":"America/New_York","latitude":44.46867,"longitude":-71.18508},{"id":143521,"geoname_id":4245481,"name":"New Berlin","ascii_name":"New Berlin","alternate_names":"Novyj Berlin,Новый Берлин","country_code":"US","country_name":"United States","admin1_code":"IL","admin2_code":"167","admin3_code":"52181","admin4_code":null,"population":1350,"elevation":198.0,"timezone":"America/Chicago","latitude":39.72533,"longitude":-89.91066}]}
curl --location --request GET 'https://zylalabs.com/api/7196/city+region+information+api/11337/city+information?name=Berlin' --header 'Authorization: Bearer YOUR_API_KEY'
| 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. La Prueba Gratuita incluye hasta 50 solicitudes.
The GET Country ISO endpoint returns country-specific data, including official names, ISO alpha-2 and alpha-3 codes, and population. The GET City Information endpoint provides detailed data about cities, including unique identifiers, official names, administrative codes, population, geographic coordinates, and time zones.
Key fields for the GET Country ISO endpoint include official name, alpha-2 code, alpha-3 code, and population. For the GET City Information endpoint, key fields include city name, geoname_id, admin codes, population, latitude, longitude, and time zone.
The response data is structured in JSON format. For the GET Country ISO endpoint, data is returned as a single object containing country details. The GET City Information endpoint returns an array of objects, each representing a city with its respective attributes, allowing easy access to multiple city records.
The GET Country ISO endpoint provides information about countries, including names and codes. The GET City Information endpoint offers detailed data on cities, including demographic information, geographic coordinates, and administrative divisions, enabling comprehensive geographic analysis.
Users can customize requests by specifying the country or city name in the parameters of each endpoint. For example, to retrieve data for a specific country, simply input the exact country name in the GET Country ISO request. This allows targeted data retrieval based on user needs.
The data is sourced from reputable geographic and demographic databases, ensuring accuracy and reliability. Regular updates and quality checks are performed to maintain data integrity, providing users with trustworthy information for their applications.
Typical use cases include geographic analysis, demographic studies, travel applications, and data integration for international systems. Businesses and developers can leverage this data for location-based services, market research, and enhancing user experiences in various applications.
If a request returns partial or empty results, check the input parameters for accuracy. Ensure the country or city name is correctly spelled and exists in the database. Implement error handling in your application to manage such scenarios gracefully, providing users with informative feedback.
Zyla API Hub es como una gran tienda de APIs, donde puedes encontrar miles de ellas en un solo lugar. También ofrecemos soporte dedicado y monitoreo en tiempo real de todas las APIs. Una vez que te registres, puedes elegir qué APIs quieres usar. Solo recuerda que cada API necesita su propia suscripción. Pero si te suscribes a varias, usarás la misma clave para todas, lo que hace todo más fácil para ti.
Los precios se muestran en USD (dólar estadounidense), EUR (euro), CAD (dólar canadiense), AUD (dólar australiano) y GBP (libra esterlina). Aceptamos todas las principales tarjetas de débito y crédito. Nuestro sistema de pago utiliza la última tecnología de seguridad y está respaldado por Stripe, una de las compañías de pago más confiables del mundo. Si tienes algún problema para pagar con tarjeta, contáctanos en [email protected]
Además, si ya tienes una suscripción activa en cualquiera de estas monedas (USD, EUR, CAD, AUD, GBP), esa moneda se mantendrá para suscripciones posteriores. Puedes cambiar la moneda en cualquier momento siempre que no tengas suscripciones activas.
La moneda local que aparece en la página de precios se basa en el país de tu dirección IP y se proporciona solo como referencia. Los precios reales están en USD (dólar estadounidense). Cuando realices un pago, el cargo aparecerá en tu estado de cuenta en USD, incluso si ves el monto equivalente en tu moneda local en nuestro sitio web. Esto significa que no puedes pagar directamente en tu moneda local.
Ocasionalmente, un banco puede rechazar el cargo debido a sus configuraciones de protección contra fraude. Te sugerimos comunicarte con tu banco primero para verificar si están bloqueando nuestros cargos. También puedes acceder al Portal de Facturación y cambiar la tarjeta asociada para realizar el pago. Si esto no funciona y necesitas más ayuda, por favor contacta a nuestro equipo en [email protected]
Los precios se determinan mediante una suscripción recurrente mensual o anual, dependiendo del plan elegido.
Las llamadas a la API se descuentan de tu plan en base a solicitudes exitosas. Cada plan incluye una cantidad específica de llamadas que puedes realizar por mes. Solo las llamadas exitosas, indicadas por una respuesta con estado 200, se contarán en tu total. Esto asegura que las solicitudes fallidas o incompletas no afecten tu cuota mensual.
Zyla API Hub funciona con un sistema de suscripción mensual recurrente. Tu ciclo de facturación comenzará el día en que compres uno de los planes de pago, y se renovará el mismo día del mes siguiente. Así que recuerda cancelar tu suscripción antes si quieres evitar futuros cargos.
Para actualizar tu plan de suscripción actual, simplemente ve a la página de precios de la API y selecciona el plan al que deseas actualizarte. La actualización será instantánea, permitiéndote disfrutar inmediatamente de las funciones del nuevo plan. Ten en cuenta que las llamadas restantes de tu plan anterior no se transferirán al nuevo plan, por lo que debes considerar esto al actualizar. Se te cobrará el monto total del nuevo plan.
Para verificar cuántas llamadas a la API te quedan en el mes actual, revisa el campo 'X-Zyla-API-Calls-Monthly-Remaining' en el encabezado de la respuesta. Por ejemplo, si tu plan permite 1,000 solicitudes por mes y has usado 100, este campo mostrará 900 llamadas restantes.
Para ver el número máximo de solicitudes a la API que permite tu plan, revisa el encabezado de la respuesta 'X-Zyla-RateLimit-Limit'. Por ejemplo, si tu plan incluye 1,000 solicitudes por mes, este encabezado mostrará 1,000.
El encabezado 'X-Zyla-RateLimit-Reset' muestra el número de segundos hasta que tu límite se restablezca. Esto te indica cuándo tu conteo de solicitudes se reiniciará. Por ejemplo, si muestra 3,600, significa que faltan 3,600 segundos para que el límite se restablezca.
Sí, puedes cancelar tu plan en cualquier momento desde tu cuenta, seleccionando la opción de cancelación en la página de Facturación. Ten en cuenta que las actualizaciones, degradaciones y cancelaciones tienen efecto inmediato. Además, al cancelar ya no tendrás acceso al servicio, incluso si te quedaban llamadas en tu cuota.
Puedes contactarnos a través de nuestro canal de chat para recibir asistencia inmediata. Siempre estamos en línea de 8 a. m. a 5 p. m. (EST). Si nos contactas fuera de ese horario, te responderemos lo antes posible. Además, puedes escribirnos por correo electrónico a [email protected]
Para darte la oportunidad de probar nuestras APIs sin compromiso, ofrecemos una prueba gratuita de 7 días que te permite realizar hasta 50 llamadas a la API sin costo. Esta prueba solo se puede usar una vez, por lo que recomendamos aplicarla a la API que más te interese. Aunque la mayoría de nuestras APIs ofrecen prueba gratuita, algunas pueden no hacerlo. La prueba finaliza después de 7 días o cuando realices 50 solicitudes, lo que ocurra primero. Si alcanzas el límite de 50 solicitudes durante la prueba, deberás "Iniciar tu Plan de Pago" para continuar haciendo solicitudes. Puedes encontrar el botón "Iniciar tu Plan de Pago" en tu perfil bajo Suscripción -> Elige la API a la que estás suscrito -> Pestaña de Precios. Alternativamente, si no cancelas tu suscripción antes del día 7, tu prueba gratuita finalizará y tu plan se cobrará automáticamente, otorgándote acceso a todas las llamadas a la API especificadas en tu plan. Ten esto en cuenta para evitar cargos no deseados.
Después de 7 días, se te cobrará el monto total del plan al que estabas suscrito durante la prueba. Por lo tanto, es importante cancelar antes de que finalice el periodo de prueba. No se aceptan solicitudes de reembolso por olvidar cancelar a tiempo.
Cuando te suscribes a una prueba gratuita de una API, puedes realizar hasta 50 llamadas. Si deseas realizar más llamadas después de este límite, la API te pedirá que "Inicies tu Plan de Pago". Puedes encontrar el botón "Iniciar tu Plan de Pago" en tu perfil bajo Suscripción -> Elige la API a la que estás suscrito -> Pestaña de Precios.
Las Órdenes de Pago se procesan entre el día 20 y el 30 de cada mes. Si envías tu solicitud antes del día 20, tu pago será procesado dentro de ese período.
Nivel de Servicio:
100%
Tiempo de Respuesta:
448ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
476ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
913ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
321ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
476ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
528ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
374ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
299ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
260ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.517ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.277ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.277ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.277ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.277ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.292ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
0ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.930ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
5.027ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
5.027ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
5.027ms
Registro gratuito
