Google Places
This document provides information about the Google Places API and the available parameters.
The Google Places API enables retrieval of Google Places search results and returns structured JSON output.
It supports local place searches for businesses, points of interest, and venues, with filters such as language, geographic location, and location targeting.
API Setup
Endpoint
https://serp-api.netnut.io/searchAuthentication
Use HTTP Basic Authentication:
Authorization: Basic <base64(username:password)>Where <base64(username:password)> is the Base64-encoded string of your NetNut credentials.
Request Format
The request is sent as a GET request. All parameters are passed directly in the URL query string.
Example Request
https://serp-api.netnut.io/search?engine=google_places&q=coffee&gl=us&hl=enRequest Parameters
engine
string
Search engine to use. For this product, use google_places.
Required
q
string
Search query or place type to search for. Example: coffee, restaurants, pharmacies.
Required
hl
string
Language of the Google Places results. Example: en.
Optional
gl
string
Geographic location for the search results. Example: us.
Optional
uule
string
Encoded location parameter used to set a precise geographic context. Overrides general country-level targeting set by gl.
Optional
location
string
Plain-text location string used to target results to a specific city or region. Example: New York, NY.
Optional
udm
integer
Google search mode parameter. Set to 1 to enable the Places results mode.
Optional
rawHtml
integer
Controls whether raw HTML is returned. 1 = return parsed JSON + HTML, 2 = return HTML only.
Optional
Code Examples
Response Format
The Google Places API returns structured JSON.
No HTML is returned by default. When rawHtml=1, the response includes both the parsed JSON and the raw HTML. When rawHtml=2, the response returns only the raw HTML.
Response Fields
Top-Level Fields
url
string
The full Google Search URL used to retrieve results.
html
string
Raw HTML of the Google Search results page. Only present when rawHtml=1 or rawHtml=2.
General Fields
searchEngine
string
The search engine used. Always google_places for this product.
resultsCount
integer
Total number of results returned.
searchTime
float
Time taken to complete the search, in seconds.
language
string
Language of the results, as set by the hl parameter.
device
string
Device type used for the search (e.g., desktop).
searchType
string
Type of search performed (e.g., text).
pageTitle
string
Title of the Google Search results page.
timestamp
string
ISO 8601 timestamp of when the search was performed.
render
boolean
Whether page rendering was used to retrieve results.
Input Fields
originalUrl
string
The original URL submitted to the API.
jobId
string
Unique identifier for the search job.
Local Result Fields
cid
string
Google's Customer ID for the place, if available.
place_id
string
Unique identifier for the place.
name
string
Name of the place.
sponsored
boolean
Whether the result is a sponsored listing.
image
string
URL of the place's image.
rating
float
Average star rating of the place.
reviews_cnt
string
Number of reviews for the place.
reviews_link
string
URL to the place's reviews on Google.
price
string
Price range indicator (e.g., $1-10).
type
string
Category or type of the place (e.g., Coffee shop).
open_state
string
Current open/closed status and next opening time.
latitude
float
Latitude coordinate of the place.
longitude
float
Longitude coordinate of the place.
top_review
string
Snippet from the top-rated review.
address
string
Address of the place.
phone
string
Phone number of the place, if available.
tags
array
List of tags or attributes associated with the place.
rank
integer
Position of the result within the current page.
global_rank
integer
Position of the result across all pages.
Pagination Fields
currentPage
integer
The current page number of the results.
Example JSON Response
Last updated