API Reference
Retrieve public Numbeo cost-of-living, quality-of-life, crime, health-care, pollution, traffic, and property indices as structured JSON. 8 endpoints documented below.
curl "https://api.crawlora.net/api/v1/numbeo/cost-of-living/rankings" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora's 8 Numbeo endpoints normalize public city and country indices into JSON. numbeo.com is a plain server-rendered site with no bot manager in front of it — the awkward part is its vocabulary of city slugs, index families, and historical periods, which these endpoints hand you directly.
Cost of living has its own routes. Everything else goes through /numbeo/indices/* with an index of quality-of-life, crime, health-care, pollution, traffic, or property-investment.
The ranking routes need no identifier at all and return every ranked city or country with its indices — plus each row's city_slug, which is the exact value the city routes expect as a path parameter.
/numbeo/cost-of-living/city/{slug} returns itemized prices grouped by category (restaurants, markets, transport, utilities, rent) with a low and high range on each item. /numbeo/indices/city/{slug} returns that city's headline and sub-indices for one family.
The country routes take a country name as Numbeo spells it and return the aggregate figures alongside every city Numbeo tracks in that country.
Ranking routes accept scope=historical with a period such as 2026-mid, 2025, or 2024. Coverage shrinks as you go back — a recent period ranks several hundred more cities than an older one — so hold the period fixed when you compare across time.
/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.
Required: slug.
Sampled 14 Oct 2026: 10 items. Filled in every item: category, items. In the sample: category: “Restaurants” and 9 other values; items: median 3 entries.
/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.
Required: country.
Sampled 14 Oct 2026: 3 items. Filled in every item: rank, city, city_slug, cost_of_living_index, rent_index, cost_of_living_plus_rent_index, groceries_index, restaurant_price_index and 1 more. In the sample: rank: 1 to 3, median 2; city: “Ho Chi Minh City” and 2 other values.
/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).
Takes no parameters.
Sampled 14 Oct 2026: 152 items. Filled in every item: rank, country, cost_of_living_index, rent_index, cost_of_living_plus_rent_index, groceries_index, restaurant_price_index, local_purchasing_power_index. In the sample: rank: 1 to 152, median 76; country: “Bermuda” and 151 other values.
/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.
Optional: scope (2 allowed values: current, historical), period.
Sampled 14 Oct 2026: 564 items. Not in every item: rank (500), city (500), city_slug (500), cost_of_living_index (500), rent_index (500), cost_of_living_plus_rent_index (500), groceries_index (500), restaurant_price_index (500) and 1 more. In the sample: rank: 1 to 500, median 250; city: “Zug, Switzerland” and 499 other values.
/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.
Required: slug, index (6 allowed values: quality-of-life, crime, health-care, pollution, traffic, property-investment).
Sampled 14 Oct 2026: 2 items. Filled in every item: name, value. In the sample: value: 46.07 to 53.93, median 46.07; name: “Crime Index” and 1 other value.
/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.
Required: country, index (6 allowed values: quality-of-life, crime, health-care, pollution, traffic, property-investment).
Sampled 14 Oct 2026: 2 items. Filled in every item: name, value. In the sample: value: 39.69 to 60.31, median 39.69; name: “Crime Index” and 1 other value.
/numbeo/indices/rankings-by-countryapiKey1 credit/requestReturns the global Numbeo ranking of countries for one index family, selected by the required `index`: `quality-of-life`, `crime`, `health-care`, `pollution`, `traffic` or `property-investment`. Each row has its `rank`, country and a list of named index values, such as the Crime Index and Safety Index for `crime`.
Required: index (6 allowed values: quality-of-life, crime, health-care, pollution, traffic, property-investment).
Sampled 14 Oct 2026: 148 items. Filled in every item: rank, country, indices. In the sample: rank: 1 to 148, median 74; country: “Papua New Guinea” and 147 other values; indices: median 2 entries.
/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.
Required: index (6 allowed values: quality-of-life, crime, health-care, pollution, traffic, property-investment). Optional: scope (2 allowed values: current, historical), period.
Sampled 14 Oct 2026: 403 items. Filled in every item: rank, city, city_slug, indices. In the sample: rank: 1 to 403, median 202; city: “Port Moresby, Papua New Guinea” and 402 other values; indices: median 2 entries.
Results from the 7 days to 14 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| Get a Numbeo city's cost-of-living prices | GET /numbeo/cost-of-living/city/Los-Angeles | 100% | 2.02 s |
| Get a Numbeo country's cost-of-living prices | GET /numbeo/cost-of-living/country?country=Vietnam | 100% | 1.92 s |
| Get the global Numbeo cost-of-living country ranking | GET /numbeo/cost-of-living/rankings-by-country | 100% | 2.12 s |
| Get the global Numbeo cost-of-living city ranking | GET /numbeo/cost-of-living/rankings | 100% | 2.52 s |
| Get a Numbeo city's data for an index family | GET /numbeo/indices/city/Los-Angeles?index=crime | 100% | 1.88 s |
| Get a Numbeo country's data for an index family | GET /numbeo/indices/country?country=Vietnam&index=crime | 100% | 1.83 s |
| Get the global Numbeo country ranking for an index family | GET /numbeo/indices/rankings-by-country?index=crime | 100% | 2.00 s |
| Get the global Numbeo city ranking for an index family | GET /numbeo/indices/rankings?index=crime | 100% | 2.18 s |