Features
A detailed overview of the Google Places API capabilities
Search Query
The q parameter is the main search input for Google Places. It accepts any place type, business name, or category keyword. Results returned will be local business listings that match the query within the targeted geographic area.
Parameter
q: string
Example
https://serp-api.netnut.io/search?engine=google_places&q=coffeeUse Cases
Local business discovery by category
Point-of-interest searches
Competitor location mapping
Language
Defines the language of the Google Places results and search interface.
Parameter
hl: string
Example
Use Cases
Retrieve results in a specific language
Localized business listings
Multi-language data pipelines
Geographic Location
Defines the country context for the Google Places search. This influences which regional listings are surfaced in the results.
Parameter
gl: string
Example
Use Cases
Country-level place discovery
Regional market research
Location-based business analysis
UULE Location Targeting
The uule parameter is an encoded location string used to set a precise geographic context for the search. It overrides general country-level targeting set by gl and allows you to simulate searches from a specific city or area.
UULE values are typically derived from Google's internal location encoding format.
Parameter
uule: string
Example
Use Cases
Simulate searches from a specific city
Reproduce a precise Google Places results page
Hyperlocal business data collection
Location
The location parameter accepts a plain-text city or region string and uses it to target results to that area. This is a simpler alternative to uule when you do not have an encoded location value available.
Parameter
location: string
Example
Use Cases
City-level place searches without encoding
Quick geographic targeting for common locations
Travel and hospitality data workflows
Places Mode (udm)
The udm parameter controls the Google search mode. Setting it to 1 activates the Places results mode, ensuring the response returns local business listings rather than standard web results.
Parameter
udm: integer
Example
Use Cases
Ensure place-specific result format
Activate local listing extraction
Prevent mixed web and place results
Raw HTML Output
Controls whether raw HTML is returned alongside or instead of the structured JSON response.
Setting rawHtml=1 appends the full HTML of the Google Places results page under the html key in the response. Setting rawHtml=2 returns only the raw HTML with no structured data.
Parameter
rawHtml: integer
Example (structured JSON plus raw HTML)
Example (raw HTML only)
Use Cases
Custom extraction logic from raw markup
Archiving the full rendered results page
Debugging structured field discrepancies
Combined Example
You can combine multiple parameters to create a more precise Google Places search.
Example
This request will:
Search Google Places for
coffeeUse English results for the US market
Apply precise location targeting via
uuleActivate Places results mode
Last updated