---
title: "Get a Numbeo country from the dataset"
method: GET
path: "/datasets/numbeo-countries/items/{country}"
tags: ["Datasets"]
---

# Get a Numbeo country from the dataset

`GET /datasets/numbeo-countries/items/{country}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/numbeo-countries/items/{country}`
- Auth: API key in header `x-api-key`

Returns one Numbeo country from the dataset by `country`, spelled as Numbeo does, such as `Vietnam`. The record has a `coverage` list and country-level indices for cost of living, rent, quality of life, crime, safety, health care, pollution, traffic and property, present only where ranked.

## Path parameters

- `country` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsNumbeoCountryResponseDoc
  - `code` integer
  - `data` EsNumbeoCountryRecord
    - `climate_index` number
    - `cost_of_living_index` number
    - `cost_of_living_plus_rent_index` number
    - `country` string
    - `coverage` string[]: Coverage lists which of the seven families ranked this entity in the current sync run, e.g. ["cost-of-living","crime","quality-of-life"].
    - `crime_index` number
    - `extra_indices` EsNumbeoNamedValue[]: ExtraIndices carries any upstream ranking column not mapped to a typed field above (future-proofing against Numbeo adding columns).
      - `name` string
      - `value` number
    - `groceries_index` number
    - `health_care_exp_index` number
    - `health_care_index` number
    - `local_purchasing_power_index` number
    - `pollution_exp_index` number
    - `pollution_index` number
    - `property_affordability_index` number
    - `property_gross_rental_yield_city_centre` number
    - `property_gross_rental_yield_outside_centre` number
    - `property_mortgage_pct_of_income` number
    - `property_price_to_income_ratio` number
    - `property_price_to_rent_ratio_city_centre` number
    - `property_price_to_rent_ratio_outside_centre` number
    - `quality_of_life_index` number
    - `rent_index` number
    - `restaurant_price_index` number
    - `safety_index` number
    - `schema_version` integer
    - `synced_at` string
    - `traffic_co2_emission_index` number
    - `traffic_index` number
    - `traffic_inefficiency_index` number
    - `traffic_time_exp_index` number
    - `traffic_time_index_minutes` number
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)