Quickstart

The fastest path from signup to first response. Two environment variables, one curl, and you'll know auth works and what's in the dataset.

1. Set two environment variables

export POI_BASE="https://beta.poi.traveltimeapp.com"
export POI_API_KEY="poi_live_..."

Your poi_live_... key arrived by email when you signed up at /signup. If you've lost it, sign up again with the same email — we email a confirmation link, and clicking it revokes the old key and sends a fresh one. See Authentication.

2. Make your first call

GET /v1/stats?country=GB is the smallest authenticated request: no body, no cells, no client-side state. Use it to confirm auth and see which snapshot you're reading against.

curl -s -H "Authorization: Bearer $POI_API_KEY" \
     "$POI_BASE/v1/stats?country=GB"

You should get a JSON body back:

{
  "total": 4633537,
  "by_source_count": { "0": 328064, "1": 2424913, "2": 1394052, "3": 486508 },
  "by_category_group": { "food_and_drink": 312044, "shopping": 501233 },
  "last_refreshed": "2026-08-06T14:16:11+00:00"
}

If the request returns 401, the key is missing, malformed, or has been revoked — re-check your POI_API_KEY value and the Bearer prefix.

Quickstart

1. Set two environment variables

2. Make your first call

Further reading