Initial location suggestions

Empty-state seed for the preferred-locations combobox: the user's IP-inferred country (via CF request.cf.country) and the top-N globally popular cities. Public endpoint, no auth required.

get/locations/initial-suggestions

Request

Base URL: https://api.aiapplyd.com/api/v1
URL: https://api.aiapplyd.com/api/v1/locations/initial-suggestions
Auth: HTTP bearer

Response

IP country + top popular cities

successtrue required

Example response

{
  "data": {
    "ipCountry": "US",
    "popularByCountry": [
      {
        "countryCode": "US",
        "countryName": "United States",
        "cities": [
          {
            "adminName1": "California",
            "country": "United States",
            "countryCode": "US",
            "flagEmoji": "🇺🇸",
            "lat": 37.7749,
            "lng": -122.4194,
            "name": "San Francisco",
            "population": 884363,
            "stateCode": "CA",
            "type": "city"
          }
        ]
      }
    ]
  },
  "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.