List Public Cities

GET

/api/v1/public/cities

const url = 'https://indepai.app/api/v1/public/cities?page=1&limit=36&region=Western%20Europe&search=Lisbon';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://indepai.app/api/v1/public/cities?page=1&limit=36&region=Western%20Europe&search=Lisbon'

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

Parameters

Query Parameters

page

Page number (1-based)

integer

default: 1 >= 1

Example

limit

Items per page (max 48)

integer

default: 36 >= 1 <= 48

Example

region

Filter by region

string

Example

Western Europe

search

Search cities by name

string

Example

Lisbon

Responses

200

Paginated city list with region filters

application/json

object

cities

required

Array<object>

object

slug

required

City slug

string

name

required

City name

string

country

required

Country name

string

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

Example

{
  "cities": [
    {
      "slug": "lisbon-portugal",
      "name": "Lisbon",
      "country": "Portugal"
    }
  ]
}