Numbeo API endpoint
Returns aggregate itemized cost-of-living prices for a country, plus the headline cost-of-living indices for every city Numbeo tracks there.
/numbeo/cost-of-living/countryQuery parameters:
country (required) — country name as Numbeo spells it, e.g. Vietnam, United States, Hong Kong (China).Response includes country, categories[] (same shape as Numbeo Cost Of Living City), cities[] (rank, city, city_slug, cost_of_living_index, rent_index, cost_of_living_plus_rent_index, groceries_index, restaurant_price_index, local_purchasing_power_index), contributors_12mo, last_update, source_url.
cities[].city_slug is the exact identifier to pass as slug to Numbeo Cost Of Living City — this is how to discover a country's cities.
| Field | Filled in, of 3 checked | Values in the sample |
|---|---|---|
| rank | 3 | 1 to 3, median 2 |
| city | 3 | “Ho Chi Minh City” and 2 other values |
| city_slug | 3 | |
| cost_of_living_index | 3 | |
| rent_index | 3 | |
| cost_of_living_plus_rent_index | 3 | |
| groceries_index | 3 | |
| restaurant_price_index | 3 | |
| local_purchasing_power_index | 3 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| country | string | Yes | Country name as Numbeo spells it | Vietnam | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/numbeo/cost-of-living/country?country=Vietnam" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"country": "Vietnam",
"categories": [
{
"category": "Restaurants",
"items": [
{
"name": "Meal at an Inexpensive Restaurant",
"currency_symbol": "₫",
"price": 50000,
"range_low": 30000,
"range_high": 100000
}
]
}
],
"cities": [
{
"rank": 1,
"city": "Ho Chi Minh City",
"city_slug": "Ho-Chi-Minh-City",
"cost_of_living_index": 29.3,
"rent_index": 13,
"cost_of_living_plus_rent_index": 21.9,
"groceries_index": 35.6,
"restaurant_price_index": 16.6,
"local_purchasing_power_index": 41.7
}
],
"contributors_12mo": 319,
"last_update": "10 July 2026",
"source_url": "https://www.numbeo.com/cost-of-living/country_result.jsp?country=Vietnam"
}
}Request schema
No body schema
Response schema
#/definitions/numbeo.costOfLivingCountryResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | numbeo.CostOfLivingCountryResponse | No | ||||
| data.categories | array | No | PriceCategory record, 7 fields: category, items. Described under Numbeo Cost Of Living City API. | |||
| data.cities | array | No | ||||
| data.cities[].city | string | No | ||||
| data.cities[].city_slug | string | No | ||||
| data.cities[].cost_of_living_index | number | No | Numbeo Cost of Living Index; a higher value means consumer goods cost more. | |||
| data.cities[].cost_of_living_plus_rent_index | number | No | Numbeo Cost of Living Plus Rent Index, which combines consumer prices and rent. | |||
| data.cities[].groceries_index | number | No | Numbeo Groceries Index; a higher value means groceries cost more. | |||
| data.cities[].local_purchasing_power_index | number | No | Numbeo Local Purchasing Power Index; a higher value means locals can afford more with their wages. | |||
| data.cities[].rank | integer | No | ||||
| data.cities[].rent_index | number | No | Numbeo Rent Index; a higher value means rent costs more. | |||
| data.cities[].restaurant_price_index | number | No | Numbeo Restaurant Price Index; a higher value means meals and drinks out cost more. | |||
| data.contributors_12mo | integer | No | ||||
| data.country | string | No | ||||
| data.last_update | string | No | ||||
| data.source_url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 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/country?country=Vietnam" \
-H "x-api-key: $CRAWLORA_API_KEY"