Response Fields
This page describes the structure and meaning of fields returned by the Google Places API
Field Summary
The table below provides a quick overview of the main fields returned by the Google Places API response.
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:
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
general
Metadata describing the request environment and search configuration.
Fields
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
input
Information about the original request processed by the API.
Fields
originalUrl
Google search URL generated from the request parameters.
jobId
Unique identifier assigned to the scraping job.
Example
pagination
Pagination metadata for the response.
Fields
currentPage
The current page number of the results.
Example
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
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
Local Result Object Fields
cid
Google Customer ID for the place. May be empty for some listings.
place_id
Unique Google identifier for the place.
name
Name of the place.
sponsored
Indicates whether the listing is a paid sponsored result.
image
Thumbnail image URL for the place.
rating
Average star rating for the place.
reviews_cnt
Total number of reviews displayed by Google.
reviews_link
Direct link to the place's reviews page on Google.
price
Price range indicator for the place.
type
Category of the place as labeled by Google.
open_state
Current open or closed status, including the next opening time when closed.
latitude
Geographic latitude coordinate of the place.
longitude
Geographic longitude coordinate of the place.
top_review
A snippet from a top user review for the place.
address
City and state where the place is located.
phone
Phone number of the place. May be empty if not available.
tags
Additional labels or highlights associated with the place.
rank
Position of the place within the current page of results.
global_rank
Position of the place across all results, regardless of page.
Example Local Result Object
Last updated