For developers

API Access

Everything you see is served by a clean, versioned REST API — the same contract that will power the upcoming native apps and partner integrations.

Authenticated public API

Create a key on your account, then call /api/public/v1/* with Authorization: Bearer <key>. Free tier: 1,000 req/mo. Paid plans raise limits + allow commercial use.

GET /api/public/v1/countries · GET /api/public/v1/prices?category=mcmeal · ?country=japan

All responses use a consistent envelope: { "data": …, "meta": … } on success, or { "error": { "message", "code" } } on failure.

Public read endpoints are cache-friendly. Programmatic access tiers, API keys and dataset exports are part of our upcoming premium plans.

GET
/api/v1/countriesList all countries with metadata.
GET
/api/v1/countries/{slug}Country detail: stats + index scores.
GET
/api/v1/categoriesAll categories and groups.
GET
/api/v1/map?index=KEYChoropleth payload for an index (ISO3-keyed).
GET
/api/v1/indices/{key}Full ranking for an index.
GET
/api/v1/compare?slugs=a,b,cCompare 2–5 countries.
POST
/api/v1/simulatorTravel budget simulation.
GET
/api/v1/arbitrage?category=KEYCross-country price arbitrage.
GET
/api/v1/exchange-ratesLatest USD-based exchange rates.
GET
/api/v1/leaderboardTop contributors.
GET / POST
/api/v1/observationsRecent prices; submit a price (auth).