// request reference
Google Local parameters
Send query parameters with GET /api/google/local. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
The groups below list every request field, including compatibility restrictions. Read the extended reference for detailed types, defaults, parameter combinations and additional examples.
Local query
Search Google’s browser-free Maps results or target one decimal local CID.
qRequired local query, up to 2,048 characters.
Example / input hint: coffee shops
ludocidOptional decimal Google local entity identifier.
Example / input hint: 15667002398697190332
tbsOptional Google compatibility token forwarded unchanged; Google may leave ranking unchanged.
Example / input hint: qdr:w
startLocal result offset through 10,000; source-exhausted offsets above 1,000 return empty.
Example / input hint: 0
Geography
Choose a human-readable location or a canonical UULE, never both.
locationHuman-readable location, up to 512 characters; conflicts with uule.
Example / input hint: Austin, Texas
uuleCanonical Google named-location token, up to 2,048 characters; conflicts with location.
Example / input hint: w+CAIQICI…
Localization
Control the first-party Google host, language, country, and request profile.
hlGoogle interface and result language.
Example / input hint: en
glTwo-letter country localization code.
Example / input hint: us
google_domainA Google domain such as google.com or google.co.uk.
Example / input hint: google.com
deviceCompatibility value: desktop, tablet, or mobile over device-invariant Maps data.
desktoptabletmobile// response
Work with the complete JSON response
Response groups include local_results, local_map, discover_more_places, pagination. Groups and fields depend on the upstream result.
The SDK examples use raise_for_error() or raiseForError() so API errors are not mistaken for successful results.