locations

Popular locations (paginated)

Offset-paginated list of popular cities ranked by population DESC. Backs the infinite-scroll browse mode of the location typeahead. Capped at 500 rows globally (2000 when scoped to a single country via countryCode) - beyond that, the client prompts the user to type. Public endpoint, no auth required.

get/locations/popular

Request

  • Base URL: https://api.aiapplyd.com/api/v1
  • URL: https://api.aiapplyd.com/api/v1/locations/popular
  • Auth: HTTP bearer

Query parameters

cursorinteger nullable

Offset into the popular-cities list. Capped at 500 when countryCode is omitted; 2000 when scoped to a single country (the country-scoped browse is the drill-in pane, which the user can exhaust further than the global browse).

limitinteger

Page size (max 50).

Example:50
countryCodestring

ISO-3166-1 alpha-2 country code. When provided, cities are filtered to that country and the pagination cap is raised so users can scroll the full city list for that country.

Example:US

Response

Page of popular cities + next cursor

successtrue required

Example response

{
  "data": {
    "items": [
      {
        "adminName1": "California",
        "country": "United States",
        "countryCode": "US",
        "flagEmoji": "🇺🇸",
        "lat": 37.7749,
        "lng": -122.4194,
        "name": "San Francisco",
        "population": 884363,
        "stateCode": "CA",
        "type": "city"
      }
    ],
    "nextCursor": 50
  },
  "meta": {
    "duration": 150,
    "requestId": "req_abc123",
    "timestamp": "2026-10-13T10:27:20.268Z",
    "version": "v1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.