# TomTom API

**Provider:** TomTom
**Category:** maps
**Base URL:** `https://api.tomtom.com`
**Auth:** api-key — `?key=YOUR_API_KEY`
**Rate Limit:** 5 requests/sec (free tier)
**Free Tier:** Yes — [object Object]
**Pricing:** Pay per use (pay-as-you-go)
**Docs:** https://developer.tomtom.com/documentation

## Description

TomTom provides a comprehensive suite of location APIs used in automotive, fleet management, and consumer applications. Features include raster and vector map tiles, forward/reverse geocoding, multi-waypoint routing with live traffic, isochrone (drive-time area) calculations, traffic flow and incidents data, EV charging station search, and long-distance trip planning with range estimation. TomTom's traffic data is used by Apple Maps, Uber, and hundreds of navigation apps worldwide.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.tomtom.com/search/2/geocode/{query}.json` | Forward geocode an address to coordinates |
| GET | `https://api.tomtom.com/search/2/reverseGeocode/{lat},{lon}.json` | Reverse geocode coordinates to an address |
| GET | `https://api.tomtom.com/routing/1/calculateRoute/{points}/json` | Calculate a route between multiple waypoints |
| GET | `https://api.tomtom.com/traffic/services/4/flowSegmentData/absolute/{zoom}/json` | Get real-time traffic flow for a road segment |
| GET | `https://api.tomtom.com/search/2/poiSearch/{query}.json` | Search for points of interest near a location |

## Authentication

Pass your API key as the key query parameter on every request. Register at developer.tomtom.com to get a key.

```
?key=YOUR_API_KEY
```

## Sample Request

```bash
curl "https://api.tomtom.com/search/2/geocode/Empire+State+Building.json?key=$TOMTOM_API_KEY&limit=1"
```

## Sample Response

```json
{
  "results": [{
    "type": "Point Address",
    "address": {
      "freeformAddress": "350 5th Avenue, New York, NY 10118",
      "country": "United States"
    },
    "position": { "lat": 40.748441, "lon": -73.985664 }
  }]
}
```

## Pricing Details

Free: 2,500 calls/day across most APIs. Pay-as-you-go: Map Tiles $0.50/1k, Geocoding $0.50/1k, Routing $0.50/1k. Volume discounts and subscription plans available.

---

*Source: [API Map](https://apimap.dev/apis/tomtom/) — CC BY 4.0*