Sign In Register

Supported Locations API

Locations API allows you to search SerpApi supported locations. It should return an array of locations ordered by reach. Locations that reach the most people will be first. This API is free to use. Download the full JSON list of supported locations:

Download

You can query https://serpapi.com/locations.json using a GET request with these parameters:

API Parameters

q

Optional

Parameter restricts your search to locations that contain the supplied string. (e.g., Austin will find 'Austin, TX', 'The University of Texas at Austin', 'Rochester, MN-Mason City, IA-Austin, MN,United States', etc.)

limit

Optional

Parameter limits the number of locations returned. (e.g., 5 will return only 5 locations. Maximum is 10.)

API Examples

Locations API example

The URL below fetches the 5 biggest locations that contains "Austin" in their name in our database. You can then use the location canonical name (e.g., "Austin,Texas,United States") or the location id (e.g., "585069efee19ad271e9c9b36") as the value of the param location for the /search API to get more precise results.

JSON Example

{
  {
    "id": "585069bdee19ad271e9bc072",
    "google_id": 200635,
    "google_parent_id": 21176,
    "name": "Austin, TX",
    "canonical_name": "Austin, TX,Texas,United States",
    "country_code": "US",
    "target_type": "DMA Region",
    "reach": 5560000,
    "gps": [
      -97.7430608,
      30.267153
    ]
  },
  {
    "id": "585069b8ee19ad271e9ba949",
    "google_id": 1026201,
    "google_parent_id": 21176,
    "name": "Austin",
    "canonical_name": "Austin,Texas,United States",
    "country_code": "US",
    "target_type": "City",
    "reach": 4870000,
    "gps": [
      -97.7430608,
      30.267153
    ]
  },
  {
    "id": "585069bdee19ad271e9bc05e",
    "google_id": 200611,
    "google_parent_id": 2840,
    "name": "Rochester, MN-Mason City, IA-Austin, MN",
    "canonical_name": "Rochester, MN-Mason City, IA-Austin, MN,United States",
    "country_code": "US",
    "target_type": "DMA Region",
    "reach": 555000
  },
  {
    "id": "585069eeee19ad271e9c9632",
    "google_id": 9060008,
    "google_parent_id": 21176,
    "name": "The University of Texas at Austin",
    "canonical_name": "The University of Texas at Austin,Texas,United States",
    "country_code": "US",
    "target_type": "University",
    "reach": 250000,
    "gps": [
      -97.7340567,
      30.2849185
    ]
  },
  {
    "id": "585069edee19ad271e9c93df",
    "google_id": 9059413,
    "google_parent_id": 21176,
    "name": "Austin County",
    "canonical_name": "Austin County,Texas,United States",
    "country_code": "US",
    "target_type": "County",
    "reach": 157000,
    "gps": [
      -96.2800864,
      29.8711291
    ]
  }
}