Search Ahead API

What is the Search Ahead API?

Search Ahead is a predictive search API that provides suggestions as a user is inputting a query.

Get Started

What 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

Provide a list of relevant suggestions to your users.

Modern Love

Search Ahead API is a lightweight, modern API.

Key Features

Addresses

Type along results for addresses.

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"
        }
      }
    }
  ]
}

Access everything you need to know about each of our APIs and SDKs. From response codes to release notes, it’s all here.

Documentation

Connect and collaborate with a community of developers who are all on the same topic.

Forum

One subscription for all your geospatial needs