TomTom API
api.tomtom.com · Location
Maps, routing, traffic, and search APIs — real-time traffic incidents, turn-by-turn navigation, matrix routing, EV charging station routing. Free: 2,500 requests/day, no credit card.
Authentication
API Key
Free API key at developer.tomtom.com (no credit card). Pass as ?key= query parameter.
Sample Requests
GET
Fuzzy search
Find pizza places near a location.
https://api.tomtom.com/search/2/search/pizza.json?key=YOUR_KEY&lat=37.337&lon=-121.89&radius=1000
Hover any highlighted part to learn what it does
curl -X GET "https://api.tomtom.com/search/2/search/pizza.json?key=YOUR_KEY&lat=37.337&lon=-121.89&radius=1000"
import requests
params = {
"key": "YOUR_KEY",
"lat": "37.337",
"lon": "-121.89",
"radius": "1000"
}
response = requests.get(
"https://api.tomtom.com/search/2/search/pizza.json",
params=params,
)
print(response.json())const url = new URL('https://api.tomtom.com/search/2/search/pizza.json');
url.searchParams.set('key', 'YOUR_KEY');
url.searchParams.set('lat', '37.337');
url.searchParams.set('lon', '-121.89');
url.searchParams.set('radius', '1000');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.tomtom.com/search/2/search/pizza.json")
q := baseURL.Query()
q.Set("key", "YOUR_KEY")
q.Set("lat", "37.337")
q.Set("lon", "-121.89")
q.Set("radius", "1000")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.tomtom.com/search/2/search/pizza.json")
uri.query = URI.encode_www_form({
"key" => "YOUR_KEY",
"lat" => "37.337",
"lon" => "-121.89",
"radius" => "1000"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.tomtom.com/search/2/search/pizza.json?" . http_build_query([
"key" => "YOUR_KEY",
"lat" => "37.337",
"lon" => "-121.89",
"radius" => "1000"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
GET
Calculate route
Calculate a driving route.
https://api.tomtom.com/routing/1/calculateRoute/52.50931,13.42936:52.50274,13.43872/json?key=YOUR_KEY&travelMode=car
Hover any highlighted part to learn what it does
curl -X GET "https://api.tomtom.com/routing/1/calculateRoute/52.50931,13.42936:52.50274,13.43872/json?key=YOUR_KEY&travelMode=car"
import requests
params = {
"key": "YOUR_KEY",
"travelMode": "car"
}
response = requests.get(
"https://api.tomtom.com/routing/1/calculateRoute/52.50931,13.42936:52.50274,13.43872/json",
params=params,
)
print(response.json())const url = new URL('https://api.tomtom.com/routing/1/calculateRoute/52.50931,13.42936:52.50274,13.43872/json');
url.searchParams.set('key', 'YOUR_KEY');
url.searchParams.set('travelMode', 'car');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.tomtom.com/routing/1/calculateRoute/52.50931,13.42936:52.50274,13.43872/json")
q := baseURL.Query()
q.Set("key", "YOUR_KEY")
q.Set("travelMode", "car")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.tomtom.com/routing/1/calculateRoute/52.50931,13.42936:52.50274,13.43872/json")
uri.query = URI.encode_www_form({
"key" => "YOUR_KEY",
"travelMode" => "car"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.tomtom.com/routing/1/calculateRoute/52.50931,13.42936:52.50274,13.43872/json?" . http_build_query([
"key" => "YOUR_KEY",
"travelMode" => "car"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- Get a free API key at developer.tomtom.com (no credit card needed)
- Pass key=YOUR_KEY on every request
- Search: GET /search/2/search/{query}.json?key=KEY&lat=LAT&lon=LON
- Route: GET /routing/1/calculateRoute/{lat1,lon1}:{lat2,lon2}/json?key=KEY
- Traffic: GET /traffic/services/5/incidentDetails?key=KEY&bbox=lon1,lat1,lon2,lat2