All sites
Data API
Google Data API
Search, news, patents and trends data from Google.
57endpointsRate Limit · recaptcha handled for you
Preview Coming soon
Preview coming soon
We're finalizing this endpoint. It isn't available to run yet, so we're not showing a sample response until it's verified live.
GET
/v1/data/google/ads1 credit / runAds
The sponsored results shown on a Google search page for a query: the top-of-page and bottom-of-page ad blocks, each with headline, destination and displayed link, description, and sitelinks.
Handled for you:Rate Limitrecaptcha
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | Search query the ads are shown for (parameter q). |
| Advanced filters | |||
| gl | string | no | Two-letter country code for the search origin, e.g. us, gb, de. (default: us) |
| hl | string | no | Two-letter UI language code, e.g. en, es, fr. (default: en) |
| location | string | no | Location to search from as free text, e.g. 'Austin, Texas'. |
| device | string | no | Device to emulate: desktop, mobile, or tablet. (default: desktop) |
| google_domain | string | no | Google domain to use, e.g. google.com, google.co.uk. (default: google.com) |