Core APIs
Locations API

Overview

5min

Locations API Overview

GET /locations

The VALUE SERP Locations API allows you to search for VALUE SERP supported Google search locations. You can supply the full_name returned by the Locations API as the location parameter in a Search API query to retrieve search results localized to that location.

The Locations API is Free of Charge There is no charge for usage of the Locations API and requests to it will not decrement your monthly search credits. However, to guarantee quality of service to all customers, we do apply a rate limit of 120 requests per minute.

To search for the location london the VALUE SERP Locations API request would be:

HTTP
Curl
Node.js
Python
PHP


To view VALUE SERP JSON results clearly in your browser we recommend these extensions for Chrome and Firefox

Here are the results from the request above, note that the locations array contains the VALUE SERP supported locations matching the query supplied in the q parameter.

JSON


Lets say we want to refine our location query to search for locations matching london that are cities within Great Britain. To do that we use the type and country_code parameters:

HTTP
Curl
Node.js
Python
PHP


Note that the results now reflect just cities within the GB country code.

JSON



Running a Search Specifying a Location

You can pass the fully qualified ( full_name ) Location name into the location parameter of a Search API request to retrieve search results from that location. In the example below we are passing the Location of Greater London,England,United Kingdom , as retrieved from the full_name property in the Locations API response, in the Search API location parameter:

HTTP
Curl
Node.js
Python
PHP