Developer API
A read-only JSON API over the same verified, evidence-backed data that powers the public pages. No key required for fair use. Every value is traceable to stored evidence; responses serve published entities only.
https://officialcost.com429 with Retry-After.Cache-Control headers./api/search?q={query}&type={type?}Ranked entity search. Optional type filter: country | city | occupation | university | visa.
https://officialcost.com/api/search?q=berlin&type=city
{
"query": "berlin",
"results": [
{ "slug": "berlin", "name": "Berlin", "type": "city",
"isoCode": null, "status": "verified", "path": "/city/berlin" }
]
}/api/graph/entities?type={type?}&limit={1-500}List published entities with their scores, ordered by importance.
https://officialcost.com/api/graph/entities?type=country&limit=100
{
"count": 100,
"entities": [
{ "slug": "germany", "name": "Germany", "type": "country",
"publicationStatus": "verified", "coverage": "82.00",
"kds": "91.0", "confidence": "88.00", "importance": "95.00",
"factCount": 41, "relationshipCount": 12 }
]
}/api/graph/entities/{slug}Full node for one entity: scores, verified facts, relationships, and contributing sources.
https://officialcost.com/api/graph/entities/germany/api/graph/entities/{slug}/historyFact version history (the time series behind trend charts).
https://officialcost.com/api/graph/entities/germany/history
{
"slug": "germany", "count": 7,
"versions": [
{ "attribute": "vat_rate_standard_pct", "version": "3",
"value": "19", "confidence": "90.00",
"changeType": "verified", "createdAt": "2026-05-01T00:00:00Z" }
]
}/api/graph/entities/{slug}/export?format=csv|jsonSingle entity's verified facts as a downloadable dataset (free tier).
https://officialcost.com/api/graph/entities/germany/export?format=csvFull-dataset exports (CSV or JSON) are a paid data product — they require a Pro or Scale API key and return 402 Paid plan required otherwise.
/api/export/ai-models?format=csv|jsonEvery AI model with input/output/blended token pricing and context window.
https://officialcost.com/api/export/ai-models?format=csv (header: x-api-key: <pro-key>)/api/export/rankings?key={ranking-key}A complete ranking (e.g. most-affordable-countries) as a dataset.
https://officialcost.com/api/export/rankings?key=most-affordable-countries/api/export/index?slug={index-slug}A flagship index (e.g. cost-of-living-2026) as a dataset.
https://officialcost.com/api/export/index?slug=cost-of-living-2026This API is provided for general guidance only and is not financial, legal, or relocation advice. Endpoints and response shapes may evolve; breaking changes will be announced.