Location figures

Send Authorization: Bearer $CASAFARI_API_KEY: a platform API key or OAuth access token, metered in platform units; see platform sign-in and Claro AI. On the platform this is POST https://platform.casafari.com/v1/claro/location; POST /v1/location is Claro's own path, which the platform adds /claro to. The platform forwards the call to Claro unchanged: Claro's Claro-Version header and its error bodies ({"error":{"code","message"}}, with rate_limited and quota_reached on a 429) pass through.

Over MCP: explain_location (equivalent). MCP and REST compared.

#Description

Footfall index (an index of pedestrian activity within a 5-minute walk that compares places with each other; not a head count, never people or visitors a day; split into weekday and weekend averages, morning/lunch/afternoon/evening and local/commuter/tourist shares of the index), residents within a 10-minute walk and drive (by age band 0-14, 15-29, 30-44, 45-59, 60+, with households, households per net income quintile and total spending power within a 10-minute walk), and nearby restaurants, fast food, cafes, shops, supermarkets, gyms and transit stops, for a premises id or any point (lat, lon) in Spain. Needs location data access on your account; a point that is not a premises is a live call on your account's location key (about 31 Targomo operations per point). A figure Targomo has no data for is null, never 0.

#Request body

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

#Example request

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

curl -X POST "https://platform.casafari.com/v1/claro/location" \
  -H "Authorization: Bearer $CASAFARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "<id>"
}'

#Responses

#200 Location figures

No body.

{
  "point": {
    "lat": 40.42,
    "lon": -3.7
  },
  "source": "precomputed",
  "figures": {
    "footfall_daily": 50000,
    "pop_walk10": 20000,
    "pop_drive10": 300000,
    "restaurants_walk5": 30,
    "transit_walk5": 5,
    "footfall_weekday": 52000,
    "footfall_weekend": 41000,
    "footfall_tourist": 9000,
    "pop_age_30_44": 5200,
    "households_walk10": 9000,
    "income_q3": 1800,
    "spending_power_walk10": 310000000
  }
}

#400 Invalid request

Type: object.

#401 Missing or invalid key

Type: object.

#403 No access

Type: object.

#429 Rate limited

Type: object.

#Related pages

• Search commercial premises (POST /v1/search)
• Refine a search (POST /v1/search/refine)
• Get one premises (GET /v1/premises/{id})
• Compare premises (POST /v1/compare)
• Claro AI: all its MCP tools and REST operations
• Connect Claro to an MCP client
• MCP vs REST API compared