Get locations typeahead suggestions scoped by country code (v1)

Send Authorization: Bearer $CASAFARI_TOKEN; see how to get a token.

Over MCP: ma_get_location_typeahead (related). MCP and REST compared.

#Description

Returns location typeahead suggestions within the given country (ES or PT).

#Request body

Content type application/json. Optional. Type: object.

#Example request

Placeholders only: replace the token and the values with your own.

curl -X POST "https://api.casafari.com/api/v1/references/locations/typeahead" \
  -H "Authorization: Bearer $CASAFARI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "country_codes": [
    "PT"
  ],
  "name": "lisboa",
  "lang": "en",
  "size": 30
}'

#Responses

#200 OK

Type: object.

{
  "typeahead": [
    {
      "location_id": 1296,
      "name": "Lisboa",
      "matched_name": "Lisboa",
      "administrative_level": "Distrito",
      "breadcrumbs": [
        {
          "location_id": 499,
          "name": "Portugal"
        },
        {
          "location_id": 1296,
          "name": "Lisboa"
        }
      ]
    }
  ]
}

#401 Unauthorized

Type: object.

#403 Forbidden

Type: object.

#Questions about this

• Which countries does Casafari cover?
• Does Casafari cover Spain and Portugal?
• Does every tool cover all 16 countries?
• How do I turn a place name into a location id?