Search Ahead API
What is the Search Ahead API?
Search Ahead is a newly updated predictive search API that provides suggestions as a user inputs a query into a search bar.
Get StartedWhat it can do for you
Reduce Errors and Poor Results
Misspelled street names and misplaced digits are a thing of the past. Autocomplete ensures a search for 1060 W. Addison St, instead of 1060 W. Adison.
Get Where You’re Going, Faster
Spend less time on manual entry and more time actually getting users to their desired point of interest.
Better User Experience
Provides a better user experience by suggesting addresses and places as the user is typing.
Modern Love
Search Ahead API is a lightweight, modern API.
Key Features
Addresses
Better support for grid addresses and intersection suggestions.
AdminAreas
Autocompletion recognizes cities (e.g. Albuquerque), zip codes (e.g. 90210) and countries (e.g. Canada).
Airports
When users enter “San,” predictive search returns both San Francisco, CA, as well as SFO.
GeoJSON
Results are GeoJSON, making them flexible and easy to integrate.
Pre-assembled DisplayString
Hit the ground running with with a pre-assembled displayString.
Customized Display
Individual components (properties) within the response allow you to customize what you display.
How it Looks
{
"request": {
"q": "den",
"limit": 10,
"collection": [
"address",
"adminArea",
"airport"
]
},
"results": [
{
"id": "mqiD: 10002325",
"displayString": "Denver International Airport (DEN), 8500 Pena Blvd, Denver, CO",
"name": "Denver International Airport (DEN)",
"recordType": "airport",
"collection": [
"airport"
],
"mqId": 10002325,
"slug": "/us/colorado/denver-international-airport-den-10002325",
"language": "en",
"place": {
"type": "Feature",
"geometry": {
"coordinates": [
-104.671828,
39.840072
],
"type": "Point"
},
"properties": {
"city": "Denver",
"stateCode": "CO",
"postalCode": "80249",
"countryCode": "US",
"street": "8500 Pena Blvd",
"type": "address"
}
}
},
{
"id": "category:86dce0d7ad4a3ed7c158bd5184e9f279",
"sic": [
"802101"
],
"displayString": "Dentists",
"name": "Dentists",
"collection": [
"category"
],
"language": "en"
},
{
"id": "category:47f912daf76a0014c575a8cde009f198",
"sic": [
"581208F97"
],
"name": "Denny's",
"recordType": "franchise",
"collection": [
"franchise"
],
"language": "en"
},
{
"id": "mqId:282932003",
"displayString": "Denver County, CO, US",
"name": "Denver County",
"recordType": "county",
"collection": [
"adminArea"
],
"language": "en",
"place": {
"type": "Feature",
"geometry": {
"coordinates": [
-104.984853,
39.738453
],
"type": "Point"
},
"properties": {
"countryCode": "US",
"county": "Denver County",
"type": "county",
"stateCode": "CO"
}
}
},
{
"id": "mqId:282041090",
"displayString": "Denver, Denver County, CO, US",
"name": "Denver",
"recordType": "city",
"collection": [
"adminArea"
],
"slug": "/us/co/denver",
"language": "en",
"place": {
"type": "Feature",
"geometry": {
"coordinates": [
-104.984853,
39.738453
],
"type": "Point"
},
"properties": {
"city": "Denver",
"stateCode": "CO",
"county": "Denver County",
"countryCode": "US",
"type": "city"
}
}
},
{
"id": "mqId:282583093",
"displayString": "The Hague, Den Haag, NL",
"name": "The Hague",
"recordType": "city",
"collection": [
"adminArea"
],
"slug": "/nl/the-hague",
"language": "en",
"place": {
"type": "Feature",
"geometry": {
"coordinates": [
4.311346,
52.079984
],
"type": "Point"
},
"properties": {
"countryCode": "NL",
"city": "The Hague",
"type": "city",
"county": "Den Haag"
}
}
},
{
"displayString": "Texel, NL",
"recordType": "city",
"collection": [
"adminArea"
],
"slug": "/nl/texel",
"language": "en",
"place": {
"type": "Feature",
"geometry": {
"coordinates": [
4.796744,
53.055272
],
"type": "Point"
},
"properties": {
"countryCode": "NL",
"city": "Texel",
"type": "city"
}
}
},
{
"displayString": "Denizli, Denizli, TR",
"recordType": "city",
"collection": [
"adminArea"
],
"slug": "/tr/denizli",
"language": "en",
"place": {
"type": "Feature",
"geometry": {
"coordinates": [
29.086313,
37.771517
],
"type": "Point"
},
"properties": {
"countryCode": "TR",
"city": "Denizli",
"type": "city",
"county": "Denizli"
}
}
},
{
"id": "mqId:282585163",
"displayString": "'s-Hertogenbosch, 's-Hertogenbosch, NL",
"name": "'s-Hertogenbosch",
"recordType": "city",
"collection": [
"adminArea"
],
"slug": "/nl/s-hertogenbosch",
"language": "en",
"place": {
"type": "Feature",
"geometry": {
"coordinates": [
5.303104,
51.688935
],
"type": "Point"
},
"properties": {
"countryCode": "NL",
"city": "'s-Hertogenbosch",
"type": "city",
"county": "'s-Hertogenbosch"
}
}
},
{
"id": "mqId:364802484",
"displayString": "Denneville, FR",
"name": "Denneville",
"recordType": "city",
"collection": [
"adminArea"
],
"slug": "/fr/denneville-364802484",
"language": "en",
"place": {
"type": "Feature",
"geometry": {
"coordinates": [
-1.660629,
49.312536
],
"type": "Point"
},
"properties": {
"countryCode": "FR",
"city": "Denneville",
"type": "city"
}
}
},
{
"id": "mqId:282584296",
"displayString": "Texel, NL",
"name": "Texel",
"recordType": "city",
"collection": [
"adminArea"
],
"slug": "/nl/texel",
"language": "en",
"place": {
"type": "Feature",
"geometry": {
"coordinates": [
4.796744,
53.055272
],
"type": "Point"
},
"properties": {
"countryCode": "NL",
"city": "Texel",
"type": "city"
}
}
},
{
"id": "mqId:282710687",
"displayString": "Denizli, Denizli, TR",
"name": "Denizli",
"recordType": "city",
"collection": [
"adminArea"
],
"slug": "/tr/denizli",
"language": "en",
"place": {
"type": "Feature",
"geometry": {
"coordinates": [
29.086313,
37.771517
],
"type": "Point"
},
"properties": {
"countryCode": "TR",
"city": "Denizli",
"type": "city",
"county": "Denizli"
}
}
}
]
}