---
title: "Get Google Maps SERP Advanced Results by id"
url: "https://docs.dataforseo.com/v3/serp/google/maps/task_get/advanced/"
date: "2026-06-06"
---
## Get Google Maps SERP Advanced Results by id
 GET https://api.dataforseo.com/v3/serp/google/maps/task\_get/advanced/$id
Pricing
Your account will be charged only for posting a task. You can get the results of the task within the next 30 days for free.
The cost can be calculated on the [Pricing](https://dataforseo.com/pricing/serp/google-maps-serp-api "Pricing") page.
**Description of the fields for sending a request:**
| Field name | Type | Description |
|---|---|---|
| `id` | string | *task identifier* [a universally unique identifier (UUID)](https://en.wikipedia.org/wiki/Universally_unique_identifier) **unique task identifier in our system** you will be able to use it within **30 days** to request the results of the task at any time |
As a response of the API server, you will receive [JSON](https://en.wikipedia.org/wiki/JSON)-encoded data containing a `tasks` array with the information specific to the set tasks.
You can also get all available SERP features and possible extra elements by making a request to the following [Sandbox](https://docs.dataforseo.com/v3/appendix/sandbox.md) URL:
`https://sandbox.dataforseo.com/v3/serp/google/maps/task_get/advanced/00000000-0000-0000-0000-000000000000`
The response will include all available items in the Google Maps SERP Advanced endpoint with the fields containing dummy data.
You won’t be charged for using [Sandbox](https://docs.dataforseo.com/v3/appendix/sandbox.md) endpoints.
**Description of the fields in the results array:**
| Field name | Type | Description |
|---|---|---|
| `version` | string | *the current version of the API* |
| `status_code` | integer | *general status code* you can find the full list of the response codes [here](https://docs.dataforseo.com/v3/appendix/errors.md) **Note:** we strongly recommend designing a necessary system for handling related exceptional or error conditions |
| `status_message` | string | *general informational message* you can find the full list of general informational messages [here](https://docs.dataforseo.com/v3/appendix/errors.md) |
| `time` | string | *execution time, seconds* |
| `cost` | float | *total tasks cost, USD* |
| `tasks_count` | integer | *the number of tasks in the **`tasks`** array* |
| `tasks_error` | integer | *the number of tasks in the **`tasks`** array returned with an error* |
| **`tasks`** | array | *array of tasks* |
| `id` | string | *task identifier* **unique task identifier in our system in the [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format** |
| `status_code` | integer | *status code of the task* generated by DataForSEO; can be within the following range: 10000-60000 you can find the full list of the response codes [here](https://docs.dataforseo.com/v3/appendix/errors.md) |
| `status_message` | string | *informational message of the task* you can find the full list of general informational messages [here](https://docs.dataforseo.com/v3/appendix/errors.md) |
| `time` | string | *execution time, seconds* |
| `cost` | float | *cost of the task, USD* |
| `result_count` | integer | *number of elements in the `result` array* |
| `path` | array | *URL path* |
| `data` | object | *contains the same parameters that you specified in the POST request* |
| **`result`** | array | *array of results* |
| `keyword` | string | *keyword received in a POST array* **the keyword is returned with decoded %## (plus symbol ‘+’ will be decoded to a space character)** |
| `type` | string | *search engine type in a POST array* |
| `se_domain` | string | *search engine domain in a POST array* |
| `location_code` | integer | *location code in a POST array* |
| `language_code` | string | *language code in a POST array* |
| `check_url` | string | *direct URL to search engine results* you can use it to make sure that we provided exact results **Note:** to check location-specific results, follow the provided check url, scroll up and down, then click the *“Search this area”* button |
| `datetime` | string | *date and time when the result was received* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2019-11-15 12:57:46 +00:00` |
| `spell` | object | *autocorrection of the search engine* if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection |
| `keyword` | string | *keyword obtained as a result of search engine autocorrection* the results will be provided for the corrected keyword |
| `type` | string | *type of autocorrection* possible values: `did_you_mean`, `showing_results_for`, `no_results_found_for`, `including_results_for` |
| `refinement_chips` | object | *search refinement chips* |
| `type` | string | *type of element = **‘refinement\_chips’*** |
| `xpath` | string | *the [XPath](https://en.wikipedia.org/wiki/XPath) of the element* |
| `items` | array | *items of the element* |
| `type` | string | *type of element = **‘refinement\_chips\_element’*** |
| `title` | string | *title of the element* |
| `url` | string | *search URL with refinement parameters* |
| `domain` | string | *domain in SERP* |
| `options` | array | *further search refinement options* |
| `type` | string | *type of element = **‘refinement\_chips\_option’*** |
| `title` | string | *title of the element* |
| `url` | string | *search URL with refinement parameters* |
| `domain` | string | *domain in SERP* |
| `item_types` | array | *types of search results in SERP* contains types of search results (`items`) found in SERP. possible item types: `maps_search`, `maps_paid_item` |
| `se_results_count` | integer | *total number of results in SERP* |
| `items_count` | integer | *the number of results returned in the **`items`** array* |
| **`items`** | array | *elements of search results found in SERP* |
| **‘Google Maps’ SERP element** | | |
| `type` | string | *type of element = **‘maps\_search’*** |
| `rank_group` | integer | *group rank in SERP* position within a group of elements with identical `type` values positions of elements with different `type` values are omitted from `rank_group` |
| `rank_absolute` | integer | *absolute rank in SERP* absolute position among all the elements in SERP |
| `domain` | string | *domain in the SERP element* |
| `title` | string | *title of the result in SERP* |
| `original_title` | string | *original title of the element* original title not translated by Google |
| `url` | string | *relevant URL in SERP* |
| `contact_url` | string | *URL of the preferred contact page* |
| `contributor_url` | string | *URL of the user’s or entity’s Local Guides profile, if available* |
| `book_online_url` | string | *URL in the ‘book online’ button of the element* URL directing users to the online booking or order page of the business entity |
| `rating` | object | *the element’s rating* the popularity rate based on reviews and displayed in SERP |
| `rating_type` | string | *the type of rating* here you can find the following elements: `Max5`, `Percents`, `CustomMax` |
| `value` | integer | *the value of the rating* |
| `votes_count` | integer | *the amount of feedback* |
| `rating_max` | integer | *the maximum value for a `rating_type`* |
| `rating_distribution` | object | *the distribution of ratings of the business entity* the object displays the number of 1-star to 5-star ratings, as reviewed by users |
| `1` | integer | *the number of 1-star ratings* |
| `2` | integer | *the number of 2-star ratings* |
| `3` | integer | *the number of 3-star ratings* |
| `4` | integer | *the number of 4-star ratings* |
| `5` | integer | *the number of 5-star ratings* | `snippet` | string | *element snippet* contains the address and other information about the local establishment featured in the element |
| `address` | string | *address line* address of the local establishment featured in the element |
| `address_info` | object | *object containing address components of the local establishment* |
| `borough` | string | *administrative unit or district the local establishment belongs to* |
| `address` | string | *street address of the local establishment* |
| `city` | string | *name of the city where the local establishment is located* |
| `zip` | string | *ZIP code of the local establishment* |
| `region` | string | *DMA region the local establishment belongs to* |
| `country_code` | string | *ISO country code of the local establishment* |
| `place_id` | string | *unique place identifier* [place id](https://developers.google.com/places/place-id) of the local establishment featured in the element |
| `phone` | string | *phone number* phone number of the local establishment featured in the element |
| `main_image` | string | *URL of the main image featured in Google My Business profile* |
| `total_photos` | integer | *total count of images featured in Google My Business profile* |
| `category` | string | *business category* Google My Business general category that best describes the services provided by the business entity |
| `additional_categories` | array | *additional business categories* additional Google My Business categories that describe the services provided by the business entity in more detail |
| `category_ids` | array | *global category IDs* universal category IDs that do not change based on the selected country |
| `work_hours` | object | *open hours* information about work hours of the local establishment |
| `timetable` | object | *work hours timetable* |
| `sunday` | array | *work hours on Sundays* |
| `open` | object | *opening time* |
| `hour` | integer | *hours in the 24-hour format* |
| `minute` | integer | *minutes* |
| `close` | object | *closing time* |
| `hour` | integer | *hours in the 24-hour format* |
| `minute` | integer | *minutes* |
| `monday` | array | *work hours on Mondays* |
| `open` | object | *opening time* |
| `hour` | integer | *hours in the 24-hour format* |
| `minute` | integer | *minutes* |
| `close` | object | *closing time* |
| `hour` | integer | *hours in the 24-hour format* |
| `minute` | integer | *minutes* |
| `tuesday` | array | *work hours on Tuesdays* |
| `open` | object | *opening time* |
| `hour` | integer | *hours in the 24-hour format* |
| `minute` | integer | *minutes* |
| `close` | object | *closing time* |
| `hour` | integer | *hours in the 24-hour format* |
| `minute` | integer | *minutes* |
| `wednesday` | array | *work hours on Wednesdays* |
| `open` | object | *opening time* |
| `hour` | integer | *hours in the 24-hour format* |
| `minute` | integer | *minutes* |
| `close` | object | *closing time* |
| `hour` | integer | *hours in the 24-hour format* |
| `minute` | integer | *minutes* |
| `thursday` | array | *work hours on Thursdays* |
| `open` | object | *opening time* |
| `hour` | integer | *hours in the 24-hour format* |
| `minute` | integer | *minutes* |
| `close` | object | *closing time* |
| `hour` | integer | *hours in the 24-hour format* |
| `minute` | integer | *minutes* |
| `friday` | array | *work hours on Fridays* |
| `open` | object | *opening time* |
| `hour` | integer | *hours in the 24-hour format* |
| `minute` | integer | *minutes* |
| `close` | object | *closing time* |
| `hour` | integer | *hours in the 24-hour format* |
| `minute` | integer | *minutes* |
| `saturday` | array | *work hours on Saturday* |
| `open` | object | *opening time* |
| `hour` | integer | *hours in the 24-hour format* |
| `minute` | integer | *minutes* |
| `close` | object | *closing time* |
| `hour` | integer | *hours in the 24-hour format* |
| `minute` | integer | *minutes* |
| `current_status` | string | *current status of the establishment* indicates whether the establishment is opened or closed |
| `feature_id` | string | *the unique identifier of the element in SERP* |
| `cid` | string | *google-defined client id* unique id of a local establishment; can be used with [Google Reviews API](https://docs.dataforseo.com/v3/reviews/google/overview.md) to get a full list of reviews |
| `latitude` | float | *latitude coordinate of the local establishments in google maps* example: `"latitude": 51.584091` |
| `longitude` | float | *longitude coordinate of the local establishment in google maps* example: `"longitude": -0.31365919999999997` |
| `is_claimed` | boolean | *indicates whether ownership of this local establishment is claimed* |
| `local_justifications` | array | *Google local justifications* snippets of text that “justify” why the business is showing up for search query |
| `type` | string | *type of local justification* posible values: `"user_review"`, `"website_mention"`, `"menu"`, `"other"` |
| `text` | string | *text snippet of local justification* |
| `is_directory_item` | boolean | *indicates whether this local establishment is a directory* |
| `price_level` | string | *property price level* can take values: `inexpensive`, `moderate`, `expensive`, `very_expensive` if there is no price level information, the value will be `null` |
| `hotel_rating` | integer | *hotel class rating* class ratings range between 1-5 stars, [learn more](https://support.google.com/business/answer/7660515?hl=en) if there is no hotel class rating information, the value will be `null` |
| **‘Local Search Ad’ SERP element** | | |
| `type` | string | *type of element = **‘maps\_paid\_item’*** |
| `rank_group` | integer | *group rank in SERP* position within a group of elements with identical `type` values positions of elements with different `type` values are omitted from `rank_group` |
| `rank_absolute` | integer | *absolute rank in SERP* absolute position among all the elements in SERP |
| `domain` | string | *domain in the SERP element* |
| `title` | string | *title of the result in SERP* |
| `original_title` | string | *original title of the element* original title not translated by Google |
| `url` | string | *relevant URL in SERP* |
| `contact_url` | string | *URL of the preferred contact page* |
| `rating` | object | *the element’s rating* the popularity rate based on reviews and displayed in SERP |
| `rating_type` | string | *the type of rating* here you can find the following elements: `Max5`, `Percents`, `CustomMax` |
| `value` | integer | *the value of the rating* |
| `votes_count` | integer | *the amount of feedback* |
| `rating_max` | integer | *the maximum value for a `rating_type`* |
| `rating_distribution` | object | *the distribution of ratings of the business entity* the object displays the number of 1-star to 5-star ratings, as reviewed by users |
| `1` | integer | *the number of 1-star ratings* |
| `2` | integer | *the number of 2-star ratings* |
| `3` | integer | *the number of 3-star ratings* |
| `4` | integer | *the number of 4-star ratings* |
| `5` | integer | *the number of 5-star ratings*
> Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access
```
# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
login="login"
password="password"
cred="$(printf ${login}:${password} | base64)"
id="02261816-2027-0066-0000-c27d02864073"
curl --location --request GET "https://api.dataforseo.com/v3/serp/google/maps/task_get/advanced/${id}"
--header "Authorization: Basic ${cred}"
--header "Content-Type: application/json"
--data-raw ""
```
```php
getHttpCode()}n";
print "Error code: {$e->getCode()}n";
print "Message: {$e->getMessage()}n";
print $e->getTraceAsString();
echo "n";
exit();
}
try {
$result = array();
// #1 - using this method you can get a list of completed tasks
// GET /v3/serp/google/maps/tasks_ready
// in addition to 'google' and 'maps' you can also set other search engine and type parameters
// the full list of possible parameters is available in documentation
$tasks_ready = $client->get('/v3/serp/google/maps/tasks_ready');
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (isset($tasks_ready['status_code']) AND $tasks_ready['status_code'] === 20000) {
foreach ($tasks_ready['tasks'] as $task) {
if (isset($task['result'])) {
foreach ($task['result'] as $task_ready) {
// #2 - using this method you can get results of each completed task
// GET /v3/serp/google/maps/task_get/advanced/$id
if (isset($task_ready['endpoint_advanced'])) {
$result[] = $client->get($task_ready['endpoint_advanced']);
}
// #3 - another way to get the task results by id
// GET /v3/serp/google/maps/task_get/advanced/$id
/*
if (isset($task_ready['id'])) {
$result[] = $client->get('/v3/serp/google/maps/task_get/advanced/' . $task_ready['id']);
}
*/
}
}
}
}
print_r($result);
// do something with result
} catch (RestClientException $e) {
echo "n";
print "HTTP code: {$e->getHttpCode()}n";
print "Error code: {$e->getCode()}n";
print "Message: {$e->getMessage()}n";
print $e->getTraceAsString();
echo "n";
}
$client = null;
?>
```
```js
const task_id = '02231256-2604-0066-2000-57133b8fc54e';
const axios = require('axios');
axios({
method: 'get',
url: 'https://api.dataforseo.com/v3/serp/google/maps/task_get/advanced/' + task_id,
auth: {
username: 'login',
password: 'password'
},
headers: {
'content-type': 'application/json'
}
}).then(function (response) {
var result = response['data']['tasks'];
// Result data
console.log(result);
}).catch(function (error) {
console.log(error);
});
```
```python
from client import RestClient
# You can download this file from here https://cdn.dataforseo.com/v3/examples/python/python_Client.zip
client = RestClient("login", "password")
# 1 - using this method you can get a list of completed tasks
# GET /v3/serp/google/maps/tasks_ready
# in addition to 'google' and 'maps' you can also set other search engine and type parameters
# the full list of possible parameters is available in documentation
response = client.get("/v3/serp/google/maps/tasks_ready")
# you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if response["status_code"] == 20000:
results = []
for task in response['tasks']:
if (task['result'] and (len(task['result']) > 0)):
for resultTaskInfo in task['result']:
# 2 - using this method you can get results of each completed task
# GET /v3/serp/google/maps/task_get/advanced/$id
if(resultTaskInfo['endpoint_advanced']):
results.append(client.get(resultTaskInfo['endpoint_advanced']))
'''
# 3 - another way to get the task results by id
# GET /v3/serp/google/maps/task_get/advanced/$id
if(resultTaskInfo['id']):
results.append(client.get("/v3/serp/google/maps/task_get/advanced/" + resultTaskInfo['id']))
'''
print(results)
# do something with result
else:
print("error. Code: %d Message: %s" % (response["status_code"], response["status_message"]))
```
```csharp
using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace DataForSeoDemos
{
public static partial class Demos
{
public static async Task serp_task_get()
{
var httpClient = new HttpClient
{
BaseAddress = new Uri("https://api.dataforseo.com/"),
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(Encoding.ASCII.GetBytes("login:password"))) }
};
// #1 - using this method you can get a list of completed tasks
// GET /v3/serp/google/maps/tasks_ready
// in addition to 'google' and 'maps' you can also set other search engine and type parameters
// the full list of possible parameters is available in documentation
var response = await httpClient.GetAsync("/v3/serp/google/maps/tasks_ready");
var tasksInfo = JsonConvert.DeserializeObject(await response.Content.ReadAsStringAsync());
var tasksResponses = new List