TomTom Search API
Browse all Tomtom APIs★ Only Publicly Available OpenAPI DocumentMaps GeolocationPlaces SearchapiKey16 EndpointsREST
For Agents
Search for addresses, POIs, and places using fuzzy, category, geometry, or along-route queries. Geocode and reverse geocode with cross-street resolution.
Use for: I need to find the coordinates for a street address, Search for gas stations along my driving route, Find all pizza restaurants within a 5 km radius, Reverse geocode GPS coordinates to get the street name
Not supported: Does not handle map tile rendering, traffic flow data, routing calculations, or fleet tracking — use for location search and geocoding only.
Jentic publishes the only available OpenAPI specification for TomTom Search API, keeping it validated and agent-ready. Run fuzzy, category, POI, nearby, and geometry-based searches across TomTom's global location database to find addresses, businesses, and points of interest. The API supports forward and structured geocoding, reverse geocoding with cross-street lookup, search along a driving route with detour-time constraints, and geometry filtering to restrict results to custom polygons or circles — all returning coordinates, address components, and POI metadata across 16 endpoints.
Install Jentic One Beta
Connect the TomTom Search API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the TomTom Search API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with TomTom Search API.
Perform fuzzy search across addresses, POIs, and geographic features with typo tolerance and typeahead support
Geocode addresses using free-form or structured queries with country code, street, and postal code components
Reverse geocode coordinates to street-level addresses with optional speed limit and road use data
Search for points of interest by category within a bounding box or radius
Find POIs along a planned driving route within a maximum detour time of up to 3600 seconds
Filter search results within custom geometry shapes (circles and polygons) via both GET and POST methods
Retrieve additional geometry data for search results using geometry UUIDs
Use Cases
Patterns agents use TomTom Search API for, with concrete tasks.
★ AI Agent Location Search via Jentic
AI agents use TomTom's fuzzy search endpoint to resolve ambiguous location references from user queries into precise coordinates and structured addresses. Through Jentic, agents search for 'find a location' and receive the operation schema for the fuzzy search endpoint, which handles misspellings, partial addresses, and POI names in a single query. The typeahead mode enables real-time suggestions, and results include coordinates, formatted addresses, and match scores.
Search for 'pizza near Times Square' using the /search/2/search/{query}.json endpoint with lat=40.758 and lon=-73.985 and return the top 3 results with coordinates
Along-Route POI Discovery for Navigation
Navigation and trip-planning applications find fuel stations, restaurants, or rest areas along a planned route without requiring significant detours. The searchAlongRoute endpoint accepts a route geometry (as an array of lat/lon points) and a maximum detour time in seconds, returning only POIs reachable within that constraint. This eliminates irrelevant results that are geographically close but require long detours to reach.
Search for 'gas' along a route from San Francisco to San Jose with a maximum detour time of 600 seconds using the /search/2/searchAlongRoute/{query}.json POST endpoint
Geometry-Based Geofence Querying
Logistics and delivery platforms query POIs within custom delivery zones defined as polygons or circles. The geometrySearch endpoint accepts a query term and a list of geometry shapes (circles with center/radius or polygons with vertices), returning only results that fall within those boundaries. The geometry filter endpoint further narrows existing result sets to custom areas.
Search for 'restaurant' within a circle of 2000m radius centered at 37.7749,-122.4194 using the /search/2/geometrySearch/{query}.json endpoint
Reverse Geocoding for Vehicle Telematics
Telematics systems convert raw GPS streams from vehicles into street-level addresses for driver logs, trip reports, and compliance records. The reverse geocode endpoint returns the street address, and optionally the posted speed limit and road use classification (arterial, local, ramp). Cross-street lookup provides the nearest intersection name for more human-friendly location descriptions.
Reverse geocode position 37.8328,-122.27669 using the /search/2/reverseGeocode/{position}.json endpoint with returnSpeedLimit=true and return the address and speed limit
Key Endpoints
16 endpoints — jentic publishes the only available openapi specification for tomtom search api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/search/{versionNumber}/search/{query}.{ext}
Fuzzy search for addresses, POIs, and features
GET
/search/{versionNumber}/geocode/{query}.{ext}
Forward geocode an address
GET
/search/{versionNumber}/structuredGeocode.{ext}
Structured geocode with address components
GET
/search/{versionNumber}/reverseGeocode/{position}.{ext}
Reverse geocode coordinates to address
GET
/search/{versionNumber}/poiSearch/{query}.{ext}
Search for points of interest
GET
/search/{versionNumber}/nearbySearch/.{ext}
Find nearby POIs by location
POST
/search/{versionNumber}/searchAlongRoute/{query}.{ext}
Search POIs along a driving route
GET
/search/{versionNumber}/geometrySearch/{query}.{ext}
Search within custom geometry shapes
GET
/search/{versionNumber}/search/{query}.{ext}
Fuzzy search for addresses, POIs, and features
GET
/search/{versionNumber}/geocode/{query}.{ext}
Forward geocode an address
GET
/search/{versionNumber}/structuredGeocode.{ext}
Structured geocode with address components
GET
/search/{versionNumber}/reverseGeocode/{position}.{ext}
Reverse geocode coordinates to address
GET
/search/{versionNumber}/poiSearch/{query}.{ext}
Search for points of interest
GET
/search/{versionNumber}/nearbySearch/.{ext}
Find nearby POIs by location
POST
/search/{versionNumber}/searchAlongRoute/{query}.{ext}
Search POIs along a driving route
GET
/search/{versionNumber}/geometrySearch/{query}.{ext}
Search within custom geometry shapes
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
TomTom API keys are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens — the raw `key` query parameter value never enters the agent's context window.
Intent-based discovery
Agents search by intent (e.g., 'search for places along a route' or 'geocode an address') and Jentic returns matching TomTom Search operations with their full input schemas, so the agent can call the correct endpoint without parsing TomTom developer docs.
Time to first call
Direct TomTom integration: 2-4 days for auth, endpoint selection across 16 operations, and error handling. Through Jentic: under 1 hour — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Alternative
LocationIQ API
OSM-based geocoding and search with routing and lower pricing
Choose LocationIQ when you need OpenStreetMap-based results, combined geocoding and turn-by-turn routing in one API, or lower-cost high-volume geocoding.
FAQs
Specific to using TomTom Search API through Jentic.
Why is there no official OpenAPI spec for TomTom Search API?
TomTom does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call TomTom Search API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the TomTom Search API use?
The TomTom Search API uses an API key passed as the `key` query parameter on every request. Through Jentic, your TomTom API key is stored encrypted in the MAXsystem vault and injected automatically — agents never see the raw key value.
Can I search for POIs along a driving route with the TomTom API?
Yes. The /search/2/searchAlongRoute/{query}.json POST endpoint accepts a route geometry (array of lat/lon points) and a `maxDetourTime` parameter (up to 3600 seconds). It returns only POIs reachable within that detour constraint, sorted by detour time from the route.
What are the rate limits for the TomTom Search API?
TomTom returns HTTP 403 when queries-per-second or account rate limits are exceeded. Free tier accounts allow 2,500 transactions per day with 5 QPS. Paid plans scale based on contract terms with higher concurrency and monthly quotas.
How do I perform a geometry-based search through Jentic?
Install the Jentic SDK with `pip install jentic` and search for 'search within a polygon'. Jentic returns the /search/2/geometrySearch/{query}.json operation schema. Pass your query term, a geometryList with POLYGON vertices or CIRCLE position/radius, and execute through Jentic to get POIs within your custom boundary.
What is the difference between fuzzy search and POI search?
Fuzzy search (/search/2/search/) queries across all index types — addresses, streets, POIs, and geographic features — with typo tolerance. POI search (/search/2/poiSearch/) is restricted to points of interest only and is optimized for business/place name queries. Use fuzzy search when the input could be anything; use POI search when you specifically want business results.
GET STARTED