---
title: "Get the global Numbeo country ranking for an index family"
method: GET
path: "/numbeo/indices/rankings-by-country"
tags: ["Numbeo"]
---

# Get the global Numbeo country ranking for an index family

`GET /numbeo/indices/rankings-by-country`

## Request

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

Returns 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`.

## Query parameters

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

## Headers

- `x-api-key` string, required

## Response `200`

OK

- NumbeoIndicesRankingsByCountryResponseDoc
  - `code` integer
  - `data` NumbeoIndicesRankingsByCountryResponse
    - `countries` NumbeoIndexRankingEntry[]: Countries ranked for this index family, in rank order.
      - `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.
    - `index` string: Index family that was requested, such as `crime` or `traffic`.
    - `source_url` string: URL the data was read from.
  - `msg` string

## Other responses

- `400`: Bad Request
- `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/028417aa35bb?raw)