Skip to main content
This section documents the sponsored ads data returned by the Google Search endpoint. Sponsored ads are part of the Google response — no separate API call is needed.

Example request

{
  "query": "running shoes",
  "country": "US"
}
This produces a response containing the ads array documented below.

Overview

Sponsored ads are paid placements shown at the top or bottom of Google Search results. Each ad includes destination URL, ad copy, and optional sitelinks.
Sponsored ads in Google Search
FieldTypeDescription
positionnumberPosition within the ad block (1-indexed)
blockPositionstringWhether the ad appeared at the top or bottom of the page
titlestringAd title
urlstringDestination URL of the ad
pagenumberPage number where the ad was found
displayedUrlstringFormatted URL as displayed in the ad
domainstringDomain name of the advertiser
descriptionstringAd description text
sitelinksarraySitelinks displayed under the ad
FieldTypeDescription
urlstringSitelink URL
titlestringSitelink title
descriptionstringSitelink description

Response example

{
  "success": true,
  "result": {
    "ads": [
      {
        "position": 1,
        "blockPosition": "top",
        "title": "Running Shoes Sale - Up to 40% Off",
        "url": "https://www.acmeshoes.com/running",
        "page": 1,
        "displayedUrl": "www.acmeshoes.com/running",
        "domain": "acmeshoes.com",
        "description": "Shop top brands of running shoes with free shipping on orders over $50.",
        "sitelinks": [
          {
            "url": "https://www.acmeshoes.com/running/road",
            "title": "Road Running",
            "description": "Lightweight shoes for paved surfaces."
          },
          {
            "url": "https://www.acmeshoes.com/running/trail",
            "title": "Trail Running",
            "description": "Durable shoes for off-road terrain."
          }
        ]
      }
    ]
  }
}