API Reference
Use Crawlora's Numbeo API endpoints to extract supported public Numbeo data as structured JSON. This documentation covers 8 active endpoints including Get a Numbeo city's cost-of-living prices, Get a Numbeo country's cost-of-living prices, Get the global Numbeo cost-of-living country ranking, Get the global Numbeo cost-of-living city ranking, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as slug, country, index, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/numbeo/cost-of-living/rankings?scope=current" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/numbeo/cost-of-living/city/{slug}apiKey2 credits/requestReturns itemized cost-of-living prices for one city (restaurants, markets, transportation, utilities, rent, and more), grouped by category. Credential-free public Numbeo data (numbeo.com).
Required params: slug:path
/numbeo/cost-of-living/countryapiKey2 credits/requestReturns aggregate itemized cost-of-living prices for a country, plus the headline cost-of-living indices for every city Numbeo tracks there. Credential-free public Numbeo data (numbeo.com).
Required params: country:query
/numbeo/cost-of-living/rankings-by-countryapiKey1 credit/requestReturns the global country-level cost-of-living ranking (Cost of Living, Rent, Cost of Living Plus Rent, Groceries, Restaurant Price, and Local Purchasing Power indices). Credential-free public Numbeo data (numbeo.com).
Required params: None
/numbeo/cost-of-living/rankingsapiKey1 credit/requestReturns the global cost-of-living city ranking (Cost of Living, Rent, Cost of Living Plus Rent, Groceries, Restaurant Price, and Local Purchasing Power indices), either the continuously-updated current index or a historical periodic snapshot. Credential-free public Numbeo data (numbeo.com).
Required params: None
/numbeo/indices/city/{slug}apiKey2 credits/requestReturns one city's data for a Numbeo index family (quality of life, crime, health care, pollution, traffic, or property investment): headline indices, and (depending on the family) titled sub-index sections and/or itemized prices. Credential-free public Numbeo data (numbeo.com).
Required params: slug:path, index:query
/numbeo/indices/countryapiKey2 credits/requestReturns one country's aggregate data for a Numbeo index family, plus every city Numbeo tracks there with its index breakdown. Credential-free public Numbeo data (numbeo.com).
Required params: country:query, index:query
/numbeo/indices/rankings-by-countryapiKey1 credit/requestReturns the global country-level ranking for a Numbeo index family. Credential-free public Numbeo data (numbeo.com).
Required params: index:query
/numbeo/indices/rankingsapiKey1 credit/requestReturns the global city ranking for a Numbeo index family, either the continuously-updated current index or a historical periodic snapshot. Credential-free public Numbeo data (numbeo.com).
Required params: index:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get a Numbeo city's cost-of-living prices | /numbeo/cost-of-living/city/{slug} | GET | 2 credits/request | slug:path | View docs | Try endpoint |
| Get a Numbeo country's cost-of-living prices | /numbeo/cost-of-living/country | GET | 2 credits/request | country:query | View docs | Try endpoint |
| Get the global Numbeo cost-of-living country ranking | /numbeo/cost-of-living/rankings-by-country | GET | 1 credit/request | None | View docs | Try endpoint |
| Get the global Numbeo cost-of-living city ranking | /numbeo/cost-of-living/rankings | GET | 1 credit/request | None | View docs | Try endpoint |
| Get a Numbeo city's data for an index family | /numbeo/indices/city/{slug} | GET | 2 credits/request | slug:path, index:query | View docs | Try endpoint |
| Get a Numbeo country's data for an index family | /numbeo/indices/country | GET | 2 credits/request | country:query, index:query | View docs | Try endpoint |
| Get the global Numbeo country ranking for an index family | /numbeo/indices/rankings-by-country | GET | 1 credit/request | index:query | View docs | Try endpoint |
| Get the global Numbeo city ranking for an index family | /numbeo/indices/rankings | GET | 1 credit/request | index:query | View docs | Try endpoint |