Skip to content
IndepAI API Docs

List Public Cities

GET
/api/v1/public/cities

Get a paginated list of cities with public-safe data. Supports search and region filtering. No authentication required.

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
page

Page number (1-based)

integer
default: 1 >= 1
Example
1
limit

Items per page (max 48)

integer
default: 36 >= 1 <= 48
Example
36
region

Filter by region

string
Example
Western Europe
search

Search cities by name

string
Example
Lisbon

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Paginated city list with region filters

object
cities
required
Array<object>
object
slug
required

City slug

string
Example
lisbon-portugal
name
required

City name

string
Example
Lisbon
country
required

Country name

string
Example
Portugal
region

Geographic region

string
nomadScore

Nomad score (0-100)

number
<= 100
monthlyCost

Monthly cost of living (USD)

number
imageUrl

City image URL

string format: uri
regions
required

Available region filter options

Array<string>
pagination
required
object
page
required
integer
limit
required
integer
total
required
integer
totalPages
required
integer