// request reference
Google Ads parameters
Send query parameters with GET /api/google/ads. 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.
Ad search
Choose both the query and the named location where Google should search.
qRequired Google Ads query, up to 2,048 characters with no controls.
Example / input hint: coffee maker
locationRequired named origin, up to 63 UTF-8 bytes once Google-encoded.
Example / input hint: Austin, Texas, United States
Localization and filtering
Control language, safety, correction, and the Google device layout.
hlGoogle interface and result language. Defaults to en.
Example / input hint: en
safeGoogle adult-content filtering.
activeoffnfprSet 1 to disable Google spelling auto-correction, or 0 to allow it.
01deviceGoogle returns its real layout for the selected device.
desktoptabletmobile// response
Work with the complete JSON response
Response groups include ads, local_ads, shopping_results, organic_results, related_questions, related_searches, 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.