locations

Popular countries (paginated)

Offset-paginated list of countries ranked by aggregate city population DESC. Backs the country-first browse mode of the location typeahead - each row drills into /locations/popular?countryCode=XX for the city-level infinite scroll. Public endpoint, no auth required.

get/locations/countries

Request

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

Query parameters

cursorinteger nullable

Offset into the countries list. The country catalogue tops out well under 500 so this is effectively a belt-and-braces cap.

limitinteger

Page size (max 50).

Example:30

Response

Page of popular countries + next cursor

successtrue required

Example response

{
  "data": {
    "items": [
      {
        "countryCode": "US",
        "countryName": "United States",
        "flagEmoji": "🇺🇸",
        "cityCount": 84,
        "population": 175000000
      }
    ],
    "nextCursor": 30
  },
  "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.