Find Cities

Returns all cities for a given country (130K+ cities worldwide with population > 1,000). Use this enrichment to build location dropdowns, validate city names, enrich leads with geographic data, or analyze market coverage by region.

[!NOTE] See the API Guide for the shared request lifecycle (sync, async polling, async webhook), error envelope, rate limits, custom_vars, and deduplication. This page documents only the fields and behaviour unique to this endpoint.

Try it

Pricing

Endpoint

Input Parameters

Available Fields

Field	Description
`name`	City name in UTF-8 (may include local characters)
`ascii_name`	ASCII transliteration of the city name
`region`	State/region name (e.g., `Bavaria`, `California`)
`population`	City population
`latitude`	Latitude coordinate
`longitude`	Longitude coordinate
`feature_code`	City classification code (see Feature Codes below)
`timezone`	IANA timezone identifier (e.g., `Europe/Berlin`)

Find Available Regions

The region filter requires an exact match of the value stored in the dataset (e.g. State of Berlin, not Berlin; Bavaria, not Bayern). Region names are sourced from GeoNames and are typically in English.

Use the picker below this page to look up the exact strings for any country, or call the public docs endpoint directly:

curl https://api.skael.de/docs/data/regions/DE

Returns:

{
  "country_code": "DE",
  "regions": ["Baden-Württemberg", "Bavaria", "Berlin", "Brandenburg", "..."]
}

This endpoint is free, cached, and rate-limited (30 requests/minute per IP). It is intended for documentation and tooling, not for production lookups — for production, store the values you need or use the find_cities enrichment.

Examples

Output Fields

Feature Codes

Code	Description
`PPLC`	Capital of a country
`PPLA`	Capital of a first-order administrative division (state/region capital)
`PPLA2`	Capital of a second-order administrative division
`PPLA3`	Capital of a third-order administrative division
`PPL`	Populated place
`PPLX`	Section of populated place

Country Coverage

The dataset includes ~142,000 cities across all countries. Top coverage:

Country	Cities
US	~17,000
FR	~9,000
MX	~8,700
DE	~7,600
IN	~6,900
IT	~6,700
BR	~5,700

Error Responses

Validation Error (422)

{
    "message": "The country code field is required.",
    "errors": {
        "country_code": ["The country code field is required."]
    }
}

Typical Response Times

Average: < 1 second (local database lookup, no external API calls)
Results are returned synchronously from the local database.