---
title: Parameters
slug: valueserp/locations-api/parameters
docTags: 
createdAt: 2024-08-03T11:00:15.050Z
---

# Parameters

<font color="#52c41a">`GET`</font>  `/locations`

The following parameters can be used to refine the results from the Locations API.

| *`Parameter`*    | *`Required`*        | *`Description`*                                                                                                                                                                                                                                                                                                                                              |
| ---------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| *`api_key`*      | <u>*`required`*</u> | The API key for your account.                                                                                                                                                                                                                                                                                                                                |
| *`q`*            | *`optional`*        | The query to use to search for locations, i.e. `new york` or `mumbai` .                                                                                                                                                                                                                                                                                      |
| *`id`*           | *`optional`*        | The `id` of a specific location (location ids are returned with all results from the Locations API).                                                                                                                                                                                                                                                         |
| *`parent_id`*    | *`optional`*        | Limits the search to child locations of the given `parent_id` . Useful for retrieving all sub-locations of a given location (all cities within a country, for example).                                                                                                                                                                                      |
| *`type`*         | *`optional`*        | Limits the results to a specific type of location. Valid values are `city` , `country` , `county` , `dma_region` , `municipality` , `neighborhood` , `state` , `postal_code` or `province` . Multiple location types should be presented as a comma seperated list (i.e. `type=state,city` to include Location results that are of type `state` or `city` ). |
| *`country_code`* | *`optional`*        | Limits the results to locations in specific countries. See [supported countries ](https://docs.trajectdata.com/valueserp/search-api/reference/google-countries)for a full list of all supported values. Multiple countries should be presented as a comma seperated list (i.e. `country_code=de,fr,us` for Germany, France and the United States).           |
| *`limit`*        | *`optional`*        | Limits the number of search results returned per page. Defaults to `10` . The maximum number of location results returned per page is `100` . Use in conjunction with the the `page` parameter to implement pagination.                                                                                                                                      |
| *`page`*         | *`optional`*        | Specifies the page of results to retrieve from `0` (first page) to a maximum page number of `100` (VALUE SERP does not support paging beyond the 100th page). Defaults to `0` . Use in conjunction with the `limit` parameter to limit the number of results returned per page.                                                                              |