tomtom.com APItomtom.com ↗
Access TomTom Traffic Index data via API. Get global city congestion rankings, AM/PM peak scores, and monthly traffic trends for cities worldwide.
curl -X GET 'https://api.parse.bot/scraper/3fe605e6-cddf-426b-a50d-77f32c3498b4/get_congestion_rankings?limit=5&countries=united-kingdom' \ -H 'X-API-Key: $PARSE_API_KEY'
Get global city congestion rankings across multiple countries. Returns cities sorted by congestion score (highest first). When no countries are specified, defaults to the first 10 countries alphabetically from the internal list.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of cities to return in the ranking. |
| countries | string | Comma-separated list of country keys to include (e.g. 'united-kingdom,mexico,united-states-of-america'). Omitting returns cities from default set of countries. |
{
"type": "object",
"fields": {
"year": "Data year (string, currently '2025')",
"ranking": "Array of city objects sorted by congestion_score descending, each containing key, name, country, ampm metrics, congestion_score, and rank",
"total_cities": "Total number of cities found across all queried countries"
},
"sample": {
"data": {
"year": "2025",
"ranking": [
{
"key": "belfast",
"ampm": {
"c": 98.9,
"s": 19498071.74,
"v": 22.4,
"fv": 44.7
},
"name": "Belfast",
"rank": 1,
"country": "United Kingdom",
"congestion_score": 98.9
}
],
"total_cities": 34
},
"status": "success"
}
}About the tomtom.com API
The TomTom Traffic Index API exposes congestion data for cities worldwide across 3 endpoints, covering global rankings, per-country rankings, and detailed city-level traffic metrics. The get_city_details endpoint returns base congestion scores alongside AM and PM peak breakdowns and a full 12-month trend array, giving developers structured access to the same index TomTom publishes annually.
Endpoints and Coverage
The API provides three endpoints. get_congestion_rankings returns a globally sorted list of cities by congestion score — a percentage indicating how much longer an average trip takes compared to free-flow conditions. You can scope it with a comma-separated countries parameter (e.g. united-kingdom,mexico,united-states-of-america) and cap results with limit. Without a countries filter, it defaults to the first 10 countries alphabetically from the internal list. The response includes year, total_cities, and a ranking array where each city object carries key, name, country, congestion_score, and AM/PM metrics.
Country and City Depth
get_country_rankings narrows results to one country at a time using a required country parameter in lowercase hyphenated format (e.g. france, united-states-of-america). It returns the same city-level fields sorted by congestion_score descending, plus a total_cities count for that country. For deeper analysis, get_city_details accepts a city key (e.g. london, new-york-ny) and returns a nested data object containing base, am, pm, and ampm metrics, as well as a monthly array covering traffic trends across the year.
Data Shape and Freshness
All three endpoints return a year field — currently '2025' — reflecting the Traffic Index edition the data corresponds to. City keys follow a consistent lowercase hyphenated convention across all endpoints, so a key value from get_congestion_rankings can be passed directly to get_city_details. The monthly array in city details enables trend visualization, showing how congestion shifts across calendar months rather than a single annual average.
- Rank cities by congestion score to inform corporate relocation or office siting decisions
- Compare AM vs PM peak congestion across cities in a specific country using
get_country_rankings - Build a monthly traffic trend chart for a target city using the
monthlyarray fromget_city_details - Filter global rankings to a custom set of countries to benchmark regional traffic conditions
- Enrich logistics route planning tools with city-level congestion scores and peak-hour differentials
- Power a public dashboard showing the most and least congested cities by country
- Support urban planning research by pulling structured annual congestion index data by city
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does TomTom have an official developer API?+
What does `get_city_details` return beyond a single congestion score?+
data object with nested base, am, pm, and ampm breakdowns, along with a monthly array that shows how congestion levels shift across the year. The year field indicates which Traffic Index edition the figures belong to.What happens if I call `get_congestion_rankings` without specifying the `countries` parameter?+
countries parameter — for example, united-states-of-america,france,germany.Does the API cover historical Traffic Index data from previous years?+
year field set to '2025'. You can fork this API on Parse and revise it to add endpoints that retrieve data from prior index years if that coverage is available on the source.