Google Search

Google Ads

Returns the Google results page for a query at a named location, including the ads, local_ads, and shopping_results groups when Google serves them. q and location are required. A missing group means Google did not serve that kind of result.

get/api/google/ads

Request

  • Base URL: https://api.litescrape.com
  • URL: https://api.litescrape.com/api/google/ads
  • Auth: one of:
    • HTTP bearer
    • API key in header zc-signature

Query parameters

qstring required
Example:coffee maker

Google Ads query, up to 2,048 characters with no control characters.

locationstring required
Example:Austin, Texas, United States

Named location to search from, up to 512 characters and at most 63 bytes once URL-encoded.

hlstring
Example:en

Google interface and result language, such as en, en-US, or de. Defaults to en.

safe'active' | 'off'

Google adult-content filtering: active or off.

nfpr'0' | '1'

Set 1 to disable Google spelling auto-correction, or 0 to allow it.

device'desktop' | 'tablet' | 'mobile'
Example:desktop

Google returns its real layout for the selected device: desktop, tablet, or mobile.

timeoutnumber

Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.

Response

Successful response; one call consumed unless noted otherwise.

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.