# Response Fields

### Field Summary

The table below provides a quick overview of the main fields returned by the Google Places API response.

| Field          | Type   | Description                                                                               |
| -------------- | ------ | ----------------------------------------------------------------------------------------- |
| `url`          | string | Final Google Places search URL used to retrieve the results.                              |
| `general`      | object | Metadata about the search environment and request configuration.                          |
| `input`        | object | Information about the original request processed by the API.                              |
| `localResults` | array  | List of local place result objects extracted from Google Places.                          |
| `pagination`   | object | Pagination metadata for the response.                                                     |
| `html`         | string | Raw HTML of the Google Search results page. Only present when `rawHtml=1` or `rawHtml=2`. |

***

### Local Result Object Fields Summary

Each element inside the `localResults` array contains the following fields:

| Field          | Type    | Description                                               |
| -------------- | ------- | --------------------------------------------------------- |
| `cid`          | string  | Google Customer ID for the place, when available.         |
| `place_id`     | string  | Unique Google place identifier.                           |
| `name`         | string  | Name of the place.                                        |
| `sponsored`    | boolean | Indicates whether the listing is a sponsored result.      |
| `image`        | string  | Thumbnail image URL for the place.                        |
| `rating`       | float   | Average star rating for the place.                        |
| `reviews_cnt`  | string  | Total number of reviews displayed by Google.              |
| `reviews_link` | string  | Direct link to the place's reviews page.                  |
| `price`        | string  | Price range indicator. Example: `$1–10`.                  |
| `type`         | string  | Place category. Example: `Coffee shop`.                   |
| `open_state`   | string  | Current open or closed status with next open time.        |
| `latitude`     | float   | Geographic latitude coordinate.                           |
| `longitude`    | float   | Geographic longitude coordinate.                          |
| `top_review`   | string  | Snippet from a top user review.                           |
| `address`      | string  | City and state of the place.                              |
| `phone`        | string  | Phone number of the place, when available.                |
| `tags`         | array   | Additional labels associated with the place.              |
| `rank`         | integer | Position of the place within the current page of results. |
| `global_rank`  | integer | Position of the place across all results.                 |

***

### Top-Level Fields

#### url

The final Google Places URL used to retrieve the results.

This URL reflects the fully constructed search query including location targeting, language, and encoded Google parameters.

**Example**

```json
"url": "https://www.google.com/search?gl=US&hl=en&q=coffee&udm=1&uule=w+CAIQICINVW5pdGVkIFN0YXRlcw"
```

***

#### general

Metadata describing the request environment and search configuration.

**Fields**

| Field          | Description                                         |
| -------------- | --------------------------------------------------- |
| `searchEngine` | Search engine used for the request.                 |
| `resultsCount` | Approximate total number of place results returned. |
| `searchTime`   | Time in seconds Google took to process the search.  |
| `language`     | Language used in the request.                       |
| `device`       | Device type used for the request.                   |
| `searchType`   | Type of search performed.                           |
| `pageTitle`    | Title of the Google Places results page.            |
| `timestamp`    | Timestamp when the request was processed.           |
| `render`       | Indicates whether rendering was enabled.            |

**Example**

```json
"general": {
  "searchEngine": "google_places",
  "resultsCount": 41,
  "searchTime": 0.35,
  "language": "en",
  "device": "desktop",
  "searchType": "text",
  "pageTitle": "coffee - Google Search",
  "timestamp": "2026-04-20T09:17:32.522961567Z",
  "render": false
}
```

***

#### input

Information about the original request processed by the API.

**Fields**

| Field         | Description                                              |
| ------------- | -------------------------------------------------------- |
| `originalUrl` | Google search URL generated from the request parameters. |
| `jobId`       | Unique identifier assigned to the scraping job.          |

**Example**

```json
"input": {
  "originalUrl": "https://www.google.com/search?gl=US&hl=en&q=coffee&udm=1&uule=w+CAIQICINVW5pdGVkIFN0YXRlcw",
  "jobId": "5ae9e608-0d7c-417d-897a-e0f3dab53be7"
}
```

***

#### pagination

Pagination metadata for the response.

**Fields**

| Field         | Description                             |
| ------------- | --------------------------------------- |
| `currentPage` | The current page number of the results. |

**Example**

```json
"pagination": {
  "currentPage": 1
}
```

***

#### html

Raw HTML of the Google Search results page. This field is only present in the response when `rawHtml=1` or `rawHtml=2` is set in the request.

* When `rawHtml=1`, the response includes both the structured JSON and the raw HTML.
* When `rawHtml=2`, the response returns only the raw HTML with no structured data.

**Example**

```json
"html": "<!doctype html><html ..."
```

***

### localResults Array

The `localResults` field contains a list of place objects extracted from Google Places. Each object represents a single business or point-of-interest listing.

**Example**

```json
"localResults": [
  { ...place object... }
]
```

***

### Local Result Object Fields

#### cid

Google Customer ID for the place. May be empty for some listings.

```json
"cid": ""
```

#### place\_id

Unique Google identifier for the place.

```json
"place_id": "6424352471498379864"
```

#### name

Name of the place.

```json
"name": "Cattle Mtn Coffee"
```

#### sponsored

Indicates whether the listing is a paid sponsored result.

```json
"sponsored": false
```

#### image

Thumbnail image URL for the place.

```json
"image": "https://lh3.googleusercontent.com/gps-cs-s/..."
```

#### rating

Average star rating for the place.

```json
"rating": 5
```

#### reviews\_cnt

Total number of reviews displayed by Google.

```json
"reviews_cnt": "52"
```

#### reviews\_link

Direct link to the place's reviews page on Google.

```json
"reviews_link": "https://www.google.com/viewer/place?..."
```

#### price

Price range indicator for the place.

```json
"price": "$10–20"
```

#### type

Category of the place as labeled by Google.

```json
"type": "Coffee shop"
```

#### open\_state

Current open or closed status, including the next opening time when closed.

```json
"open_state": "Closed · Opens 6 AM Thu"
```

#### latitude

Geographic latitude coordinate of the place.

```json
"latitude": 37.669144
```

#### longitude

Geographic longitude coordinate of the place.

```json
"longitude": -106.63993
```

#### top\_review

A snippet from a top user review for the place.

```json
"top_review": "\"Great coffee, amazing breakfast sandwich, all for a total of $13.\""
```

#### address

City and state where the place is located.

```json
"address": "South Fork, CO"
```

#### phone

Phone number of the place. May be empty if not available.

```json
"phone": ""
```

#### tags

Additional labels or highlights associated with the place.

```json
"tags": []
```

#### rank

Position of the place within the current page of results.

```json
"rank": 1
```

#### global\_rank

Position of the place across all results, regardless of page.

```json
"global_rank": 1
```

***

### Example Local Result Object

```json
{
  "cid": "",
  "place_id": "6424352471498379864",
  "name": "Cattle Mtn Coffee",
  "sponsored": false,
  "image": "https://lh3.googleusercontent.com/gps-cs-s/...",
  "rating": 5,
  "reviews_cnt": "52",
  "reviews_link": "https://www.google.com/viewer/place?...",
  "price": "$10–20",
  "type": "Coffee shop",
  "open_state": "Closed · Opens 6 AM Thu",
  "latitude": 37.669144,
  "longitude": -106.63993,
  "top_review": "\"Great coffee, amazing breakfast sandwich, all for a total of $13.\"",
  "address": "South Fork, CO",
  "phone": "",
  "tags": [],
  "rank": 1,
  "global_rank": 1
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.netnut.io/netnut-documentation/netnut-scraper-apis/serp-api/google-scraper/google-places/response-fields.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.