Numbeo API endpoint
Returns 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).
/numbeo/cost-of-living/rankings-by-countryNo parameters.
Response includes countries[] (rank, country, cost_of_living_index, rent_index, cost_of_living_plus_rent_index, groceries_index, restaurant_price_index, local_purchasing_power_index), source_url.
| Field | Filled in, of 152 checked | Values in the sample |
|---|---|---|
| rank | 152 | 1 to 152, median 76 |
| country | 152 | “Bermuda” and 151 other values |
| cost_of_living_index | 152 | |
| rent_index | 152 | |
| cost_of_living_plus_rent_index | 152 | |
| groceries_index | 152 | |
| restaurant_price_index | 152 | |
| local_purchasing_power_index | 152 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/numbeo/cost-of-living/rankings-by-country" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"countries": [
{
"rank": 1,
"country": "Bermuda",
"cost_of_living_index": 135.8,
"rent_index": 105.9,
"cost_of_living_plus_rent_index": 122.1,
"groceries_index": 149,
"restaurant_price_index": 136.8,
"local_purchasing_power_index": 104.3
}
],
"source_url": "https://www.numbeo.com/cost-of-living/rankings_by_country.jsp"
}
}Request schema
No body schema
Response schema
#/definitions/numbeo.rankingsByCountryResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | numbeo.RankingsByCountryResponse | No | ||||
| data.countries | array | No | Countries in Numbeo's cost-of-living ranking, in rank order. | |||
| data.countries[].cost_of_living_index | number | No | Numbeo Cost of Living Index; a higher value means consumer goods cost more. | |||
| data.countries[].cost_of_living_plus_rent_index | number | No | Numbeo Cost of Living Plus Rent Index, which combines consumer prices and rent. | |||
| data.countries[].country | string | No | Country name as Numbeo shows it. | |||
| data.countries[].groceries_index | number | No | Numbeo Groceries Index; a higher value means groceries cost more. | |||
| data.countries[].local_purchasing_power_index | number | No | Numbeo Local Purchasing Power Index; a higher value means locals can afford more with their wages. | |||
| data.countries[].rank | integer | No | Position of the country in Numbeo's cost-of-living ranking, starting at 1. | |||
| data.countries[].rent_index | number | No | Numbeo Rent Index; a higher value means rent costs more. | |||
| data.countries[].restaurant_price_index | number | No | Numbeo Restaurant Price Index; a higher value means meals and drinks out cost more. | |||
| data.source_url | string | No | URL the data was read from. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/numbeo/cost-of-living/rankings-by-country" \
-H "x-api-key: $CRAWLORA_API_KEY"