This document is generated by Aladia.

Aladia API

Search Cities

Developing

GET

/global/cities/search

This endpoint searches cities using their names, state names, and country names.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.aladia.io/v2/global/cities/search?name=Finote selam&stateName=Amhara Region&countryName=Ethiopia&limit=50&next=&prev=&sortBy=&sortDirection=asc&query=' \
--header 'apikey: '

Response Example

200 - Success

{
  "data": [
    {
      "id": "66dacd0d773e6e2d12a5137g",
      "name": "temporibus unde magni",
      "stateName": "corrupti a dolore",
      "countryName": "unde sed quibusdam"
    },
    {
      "id": "66dacd0d773e6e2d12a51374j",
      "name": "nobis assumenda sit",
      "stateName": "nobis voluptates laboriosam",
      "countryName": "itaque dolorem iste"
    },
    {
      "id": "66dacd0d773e6e2d12a5137h",
      "name": "aperiam repellendus dolorum",
      "stateName": "pariatur ipsum explicabo",
      "countryName": "maiores occaecati soluta"
    }
  ],
  "cursor": {
    "next": null,
    "prev": null,
    "totalItems": 3
  }
}

Request

Query Params

name

string

optional

Name of the city

Example:

Finote selam

stateName

string

optional

State where the city belongs

Example:

Amhara Region

countryName

string

optional

Country where the city belongs

Example:

Ethiopia

limit

integer

optional

Number of documents per page in the response

Default:

string

optional

Next token cursor, to navigate towards the next page

string

optional

Previous token cursor, to navigate towards the previous page

sortBy

string

optional

Optional field to be used as a sorting reference

sortDirection

enum<string>

optional

Set the results in ascending (asc) or descending (desc) direction

Allowed values:

ascdesc

Default:

asc

query

string

optional

The search query string.

Header Params

apikey

string

optional

Example:

Responses

🟢200Success

application/json

Body

data

array[object (city.model) {6}]

required

string

required

id of the state

name

string

optional

name of the state

stateName

string

optional

the state where the city belongs

countryName

string

optional

the country where the state belongs

latitude

string

optional

latitude of the city

longitude

string

required

longitude of the city

cursor

object (cursor)

required

string | null

required

string | null

required

totalItems

integer

required

🟠422Parameter Error

Modified at 2025-04-09 13:58:49

List All Cities

Search Brand Fetch Brands