ApogeoAPI icon

ApogeoAPI

IP geolocation, countries, cities, and exchange rates

Actions8

Country → Get Cities

AI-generated

Summary

Retrieve a list of cities within a specified country, optionally filtered by state or province and limited in number.

Inputs

  • Country Code (required) — ISO 3166-1 alpha-2 country code (e.g. US, DE, AR).
  • State — Optional state or province name to filter cities.
  • Limit — Maximum number of cities to return (between 1 and 500, default 50).

Output shape

a list of city records in JSON format

The returned data is an array of city objects. If the API response is a single object, it is wrapped in an array for consistency.

Examples

Example 1: Get up to 100 cities in the United States, filtered by the state of California.

Set Country Code to 'US', State to 'California', and Limit to 100.

Links

Discussion