Reference Statistics

The statistics endpoints expose aggregated hotel counts across the reference inventory. Retrieve a global summary, a ranked list of countries, or city-level detail for a specific country. These endpoints support globe or map visualizations, dashboards, and coverage reporting.

GET /api/v1/reference/statistics

Retrieve global statistics across the entire reference inventory, including hotel counts broken down by country and city.

GET https://api.mapping.travel/api/v1/reference/statistics

Response

number

required

Total number of reference hotels in the inventory.

number

required

Number of distinct countries represented.

number

required

Number of distinct cities represented.

object[]

List of countries with their hotel counts.

Show country entry properties

string

Country name.

number

Number of reference hotels in this country.

Example

curl https://api.mapping.travel/api/v1/reference/statistics

{
  "totalHotels": 1284500,
  "totalCountries": 192,
  "totalCities": 48320,
  "byCountry": [
    { "country": "United States", "hotelCount": 142300 },
    { "country": "Germany", "hotelCount": 87400 }
  ]
}

GET /api/v1/reference/statistics/countries

Retrieve countries ranked by hotel count.

GET https://api.mapping.travel/api/v1/reference/statistics/countries

Query parameters

number

default:"20"

Maximum number of countries to return. Clamped to 1 to 200.

Response

Returns an array of country statistics objects, sorted descending by hotel count.

string

required

Country name.

number

required

Number of reference hotels in this country.

Example

curl "https://api.mapping.travel/api/v1/reference/statistics/countries?limit=10"

[
  { "country": "United States", "hotelCount": 142300 },
  { "country": "Germany", "hotelCount": 87400 },
  { "country": "France", "hotelCount": 74100 }
]

GET /api/v1/reference/statistics/countries/

Retrieve detailed statistics for a single country, including a breakdown of hotel counts per city.

GET https://api.mapping.travel/api/v1/reference/statistics/countries/{country}

Path parameters

string

required

Country name. Must match the name as it appears in the inventory (e.g. France, United States).

Response

string

required

Country name.

number

required

Total hotel count for this country.

object[]

required

List of cities in this country with their hotel counts.

Show city entry properties

string

City name.

number

Number of hotels in this city.

Errors

Status	Description
`404 Not Found`	The specified country was not found in the inventory.

Example

curl "https://api.mapping.travel/api/v1/reference/statistics/countries/France"

{
  "country": "France",
  "totalHotels": 74100,
  "cities": [
    { "city": "Paris", "hotelCount": 12400 },
    { "city": "Lyon", "hotelCount": 5300 },
    { "city": "Marseille", "hotelCount": 4800 }
  ]
}

Country names are case-sensitive and must match the inventory’s stored form. Use GET /api/v1/reference/statistics/countries first to discover the exact country names available.

Inventory

Mapping

Reference Hotels

Suppliers

Webhooks

Export

GET /api/v1/reference/statistics

Response

Example

GET /api/v1/reference/statistics/countries

Query parameters

Response

Example

GET /api/v1/reference/statistics/countries/

Path parameters

Response

Errors

Example

​GET /api/v1/reference/statistics

​Response

​Example

​GET /api/v1/reference/statistics/countries

​Query parameters

​Response

​Example

​GET /api/v1/reference/statistics/countries/

​Path parameters

​Response

​Errors

​Example

GET /api/v1/reference/statistics

Response

Example

GET /api/v1/reference/statistics/countries

Query parameters

Response

Example

GET /api/v1/reference/statistics/countries/

Path parameters

Response

Errors

Example