---
title: "Get a Numbeo country's data for an index family"
method: GET
path: "/numbeo/indices/country"
tags: ["Numbeo"]
---

# Get a Numbeo country's data for an index family

`GET /numbeo/indices/country`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/numbeo/indices/country`
- Auth: API key in header `x-api-key`

Returns one country's aggregate data for a Numbeo index family, plus every city Numbeo tracks there with its index breakdown.

## Query parameters

- `country` string, required
- `index` 'quality-of-life' | 'crime' | 'health-care' | 'pollution' | 'traffic' | 'property-investment', required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- NumbeoIndicesCountryResponseDoc
  - `code` integer
  - `data` NumbeoIndicesCountryResponse
    - `cities` NumbeoIndexRankingEntry[]
      - `city` string: City name as Numbeo shows it. Set on city rankings.
      - `city_slug` string: Numbeo city slug. Set on city rankings.
      - `country` string: Country name as Numbeo shows it. Set on country rankings.
      - `indices` NumbeoNamedValue[]: Index values Numbeo publishes for this row, in table column order.
        - `name` string: Name of the index, as Numbeo labels it, such as `Crime Index`.
        - `value` number: Value of the index named in `name`.
      - `rank` integer: Position in the Numbeo ranking, starting at 1.
    - `contributors_note` string
    - `country` string
    - `headline_indices` NumbeoNamedValue[]
      - `name` string: Name of the index, as Numbeo labels it, such as `Crime Index`.
      - `value` number: Value of the index named in `name`.
    - `index` string
    - `last_update` string
    - `price_categories` NumbeoPriceCategory[]
      - `category` string: Numbeo section name, such as Restaurants, Markets or Rent Per Month.
      - `items` NumbeoPriceItem[]: Priced goods and services listed under this category.
        - `currency_symbol` string: Currency symbol Numbeo shows for the city's local currency, such as `$` or `€`.
        - `name` string: Name of the good or service, such as a meal at an inexpensive restaurant.
        - `price` number: Price of the item in the city's local currency, as shown on Numbeo.
        - `range_high` number: High end of the price range Numbeo reports for the item.
        - `range_low` number: Low end of the price range Numbeo reports for the item.
    - `sections` NumbeoIndexSection[]
      - `rows` NumbeoIndexRow[]
        - `name` string
        - `qualifier` string
        - `value` number
      - `title` string
    - `source_url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[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/afac9b012a27?raw)