{"api_version":"v1","generated_at":"2025-09-12T09:30:16.000Z","base_url":"https://cdn.jsdelivr.net/npm/geo-data-api@latest/dist/api/v1","statistics":{"total_countries":250,"total_states":5099,"total_cities":151165,"regions":6,"subregions":22,"state_types":["province","municipality","district","county","atoll","parish","dependency","city","region","capital city","territory","state","autonomous republic","governorate","division","oblast","department","special municipality","canton","entity","federal district","autonomous municipality","geographical region","prefecture","commune","economic prefecture","autonomous region","special administrative region","capital district","island","autonomous district","administration","metropolitan department","European collectivity","metropolitan region","metropolitan collectivity with special status","overseas region","overseas collectivity","overseas territory","land","regional unit","administrative region","village","city with county rights","union territory","Special region","free municipal consortium","decentralized regional entity","metropolitan city","state city","popularate","district municipality","federal territory","administrative atoll","local council","sheadings","chain","autonomous territorial unit","territorial unit","quarter","special island authority","capital territory","special city","arctic region","administered area","federal capital territory","indigenous region","capital","voivodship","republic","administrative territory","autonomous city","area","urban municipality","special self-governing province","special self-governing city","autonomous community","districts under republic administration","metropolitan administration","borough","town council","island council","emirate","council area","unitary authority","district council","borough council","london borough","metropolitan district","two-tier county","country","outlying area","federal dependency"],"cities_with_wikidata":150853,"states_with_coordinates":5099,"cities_with_coordinates":151165},"data_analysis":{"countries":{"total":250,"regions":6,"subregions":22,"currencies":155},"states":{"total":5099,"types":["province","municipality","district","county","atoll","parish","dependency","city","region","capital city","territory","state","autonomous republic","governorate","division","oblast","department","special municipality","canton","entity","federal district","autonomous municipality","geographical region","prefecture","commune","economic prefecture","autonomous region","special administrative region","capital district","island","autonomous district","administration","metropolitan department","European collectivity","metropolitan region","metropolitan collectivity with special status","overseas region","overseas collectivity","overseas territory","land","regional unit","administrative region","village","city with county rights","union territory","Special region","free municipal consortium","decentralized regional entity","metropolitan city","state city","popularate","district municipality","federal territory","administrative atoll","local council","sheadings","chain","autonomous territorial unit","territorial unit","quarter","special island authority","capital territory","special city","arctic region","administered area","federal capital territory","indigenous region","capital","voivodship","republic","administrative territory","autonomous city","area","urban municipality","special self-governing province","special self-governing city","autonomous community","districts under republic administration","metropolitan administration","borough","town council","island council","emirate","council area","unitary authority","district council","borough council","london borough","metropolitan district","two-tier county","country","outlying area","federal dependency"],"timezones":352,"with_coordinates":5099},"cities":{"total":151165,"countries":209,"with_wikidata":150853,"with_coordinates":151165,"timezones":0},"distribution":{"top_countries_by_cities":[["United States",19786],["France",10243],["Italy",9947],["Mexico",9321],["Spain",8427]],"top_countries_by_states":[["United Kingdom",247],["Slovenia",211],["Uganda",139],["France",123],["Italy",111]]}},"endpoints":{"countries":{"list":"countries.json","individual":"countries/{iso2}.json","by_region":"countries/region/{region-name}.json","by_subregion":"countries/subregion/{subregion-name}.json","regions_index":"countries/regions.json"},"states":{"all":"states/all.json","by_country":"states/country/{country_iso2}.json","by_type":"states/type/{type-name}.json","by_timezone":"states/timezone/{timezone-name}.json","individual":"states/{iso3166_2}.json","types_index":"states/types.json","timezones_index":"states/timezones.json"},"cities":{"by_country":"cities/country/{country_iso2}.json","country_shards_index":"cities/country/{country_iso2}/index.json","by_state":"cities/state/{state_iso3166_2}.json","batches":"cities/batches.json","batch":"cities/batch/{filename}"},"search":{"countries":"search/countries.json","states":"search/states.json","city_shards_index":"search/cities/index.json","cities_by_country":"search/cities/country/{iso2}.json","combined_sample":"search/combined-sample.json","combined":"search/combined.json"}},"usage_examples":{"Get all countries":"https://cdn.jsdelivr.net/npm/geo-data-api@latest/dist/api/v1/countries.json","Get Afghanistan details":"https://cdn.jsdelivr.net/npm/geo-data-api@latest/dist/api/v1/countries/af.json","Get Asian countries":"https://cdn.jsdelivr.net/npm/geo-data-api@latest/dist/api/v1/countries/region/asia.json","Get states by country":"https://cdn.jsdelivr.net/npm/geo-data-api@latest/dist/api/v1/states/country/us.json","Get provinces only":"https://cdn.jsdelivr.net/npm/geo-data-api@latest/dist/api/v1/states/type/province.json","Get cities by state":"https://cdn.jsdelivr.net/npm/geo-data-api@latest/dist/api/v1/cities/state/us-ca.json","Get city batch index":"https://cdn.jsdelivr.net/npm/geo-data-api@latest/dist/api/v1/cities/batches.json","Search countries":"https://cdn.jsdelivr.net/npm/geo-data-api@latest/dist/api/v1/search/countries.json"},"notes":{"city_search":"The global city search file is omitted; country shards together cover all cities","pagination":"Complete country and state lists are available; large country city lists also have optional indexed chunks","coordinates":"Geographic coordinates available for most locations","wikidata":"WikiData IDs available for enhanced city information","timezones":"Timezone information is available where supplied by the source dataset","city_batches":"Batch index filenames are complete paths relative to the API base URL","types":"States include type information (province, state, region, etc.)"}}