Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mapping.travel/llms.txt

Use this file to discover all available pages before exploring further.

The statistics endpoints expose aggregated hotel counts across the reference inventory. You can retrieve a global summary, a ranked list of countries, or city-level detail for a specific country. These endpoints are designed to 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

​
totalHotels
number
required
Total number of reference hotels in the inventory.
​
totalCountries
number
required
Number of distinct countries represented.
​
totalCities
number
required
Number of distinct cities represented.
​
byCountry
object[]
List of countries with their hotel counts.

​
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

​
limit
number
default:"20"
Maximum number of countries to return. Clamped to 1–200.

​
Response

Returns an array of country statistics objects, sorted descending by hotel count.
​
country
string
required
Country name.
​
hotelCount
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

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

​
Response

​
country
string
required
Country name.
​
totalHotels
number
required
Total hotel count for this country.
​
cities
object[]
required
List of cities in this country with their hotel counts.

​
Errors

StatusDescription
404 Not FoundThe 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.