Logo SearchApi

Google Ads Transparency Center Ad Details API Documentation

Google Ads Transparency Center Ad Details API uses the /api/v1/search?engine=google_ads_transparency_center_ad_details endpoint to retrieve parsed ad variations and detailed ad information for each geographic region where ads were shown.

API Parameters

Search Params

  • Name
    advertiser_id
    Required
    Required
    Description

    Specifies the advertiser's unique ID. You can obtain the advertiser_id in two ways:

    • Use our Advertiser Search API to search for advertisers or domain by keyword.
    • Use our Google Ads Advertiser Info API to retrieve the advertiser ID directly.
    • Inspect the URL from the Google Ads Transparency Center website and locate the path segment that starts with AR.

  • Name
    creative_id
    Required
    Required
    Description

    Specifies the creative's unique ID. You can obtain the creative_id in two ways:

    • Use our Google Ads Transparency Center API to retrieve the creative ID directly.
    • Inspect the URL from the Google Ads Transparency Center website and locate the path segment that starts with CR.

Engine

  • Name
    engine
    Required
    Required
    Description

    Specifies the search engine. Must be set to google_ads_transparency_center_ad_details.

Api Key

  • Name
    api_key
    Required
    Required
    Description

    Your API key for authentication. Include it as a query parameter (?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

API Examples

Ad Information

Ad Information
GET
https://www.searchapi.io/api/v1/search?advertiser_id=AR17828074650563772417&creative_id=CR08581524376019533825&engine=google_ads_transparency_center_ad_details
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_ads_transparency_center_ad_details",
  "advertiser_id": "AR17828074650563772417",
  "creative_id": "CR08581524376019533825"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "ad_information": {
    "format": "video",
    "topic": "Business & Industrial",
    "first_shown_date": "2025-04-09",
    "last_shown_date": "2025-04-23",
    "last_shown_datetime": "2025-04-23T21:14:41Z",
    "impressions_data_available_from": "2025-07-08",
    "regions": [
      {
        "region_code": 2276,
        "code": "DE",
        "name": "Germany",
        "first_shown_date": "2025-04-09",
        "last_shown_date": "2025-04-23"
      }
    ],
    "audience_selection": {
      "demographic_info": "Some included, some excluded",
      "geographic_locations": "Some included, some excluded",
      "contextual_signals": "Some included, some excluded",
      "customer_lists": "Some included, some excluded"
    }
  }
}

Ad Information by Regions

Ad Information by Regions
GET
https://www.searchapi.io/api/v1/search?advertiser_id=AR17828074650563772417&creative_id=CR17502517606995722241&engine=google_ads_transparency_center_ad_details
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_ads_transparency_center_ad_details",
  "advertiser_id": "AR17828074650563772417",
  "creative_id": "CR17502517606995722241"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "ad_information": {
    "format": "text",
    "topic": "Business & Industrial",
    "first_shown_date": "2023-07-29",
    "last_shown_date": "2024-10-16",
    "last_shown_datetime": "2024-10-16T18:13:33Z",
    "regions": [
      {
        "region_code": 2276,
        "code": "DE",
        "name": "Germany",
        "first_shown_date": "2023-07-31",
        "last_shown_date": "2024-04-11",
        "impressions": {
          "lower": 0,
          "upper": 1000
        },
        "platform_impressions": [
          {
            "platform": "google_search",
            "lower": 0,
            "upper": 1000
          }
        ]
      }
      ...
    ],
    "audience_selection": {
      "demographic_info": "Some included, some excluded",
      "geographic_locations": "Some included, some excluded",
      "contextual_signals": "Some included, some excluded",
      "topics_of_interest": "Excluded",
      "customer_lists": "Excluded"
    }
  }
}

Variations - Video Ads

Variations - Video Ads
GET
https://www.searchapi.io/api/v1/search?advertiser_id=AR17828074650563772417&creative_id=CR14400445986759507969&engine=google_ads_transparency_center_ad_details
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_ads_transparency_center_ad_details",
  "advertiser_id": "AR17828074650563772417",
  "creative_id": "CR14400445986759507969"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "variations": [
    {
      "title": "Monitora i consumi energetici",
      "link": "http://www.tesla.com/it_it/powerwall/get",
      "description": "Sfrutta Powerwall quando l'energia costa di più o in caso di blackout",
      "long_headline": "Tesla Powerwall 3 immagazzina energia per mantenere la tua casa alimentata giorno e notte",
      "thumbnail": "https://i.ytimg.com/vi/Y7TWpkZnebY/hqdefault.jpg",
      "video_link": "https://www.youtube.com/watch?v=Y7TWpkZnebY",
      "domain": "tesla.com"
    },
    {
      "video_id": "Y7TWpkZnebY",
      "video_link": "https://www.youtube.com/watch?v=Y7TWpkZnebY",
      "duration": "0:45",
      "channel": "Tesla",
      "domain": "tesla.com",
      "is_skippable": "true"
    },
    ...
  ]
}

Variations - Text Ads

Variations - Text Ads
GET
https://www.searchapi.io/api/v1/search?advertiser_id=AR15908226811872411649&creative_id=CR05745684721761779713&engine=google_ads_transparency_center_ad_details
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_ads_transparency_center_ad_details",
  "advertiser_id": "AR15908226811872411649",
  "creative_id": "CR05745684721761779713"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "variations": [
    {
      "title": "Airbnb Englewood - Englewood Rentals",
      "displayed_link": "www.airbnb.com/englewood",
      "snippet": "Book a Highly Rated Rental in Englewood. Entire Homes, Unique Rooms, Hotels & More. Feel at Home in Englewood with Airbnb. Book Your Perfect Vacation. Low Prices. Over 100,000 Cities.",
      "sitelinks": [
        {
          "title": "Monthly Stays",
          "snippet": "Homes available for a month or more with wifi, full kitchens & more."
        },
        {
          "title": "What is Airbnb?",
          "snippet": "A way to find unique getaways with space and amenities you want."
        },
        {
          "title": "Explore Homes in Englewood"
        },
        {
          "title": "Pet-Friendly Airbnbs"
        }
      ]
    },
    ...
  ]
}

Variations - Image Ads

Variations - Image Ads
GET
https://www.searchapi.io/api/v1/search?advertiser_id=AR06114808917148041217&creative_id=CR12412563443737952257&engine=google_ads_transparency_center_ad_details
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_ads_transparency_center_ad_details",
  "advertiser_id": "AR06114808917148041217",
  "creative_id": "CR12412563443737952257"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "variations": [
  {
    "title": "Markenartikel zum Sparpreis",
    "snippet": "Jetzt praktische Kinderwagen, hochwertiges Kindermöbel & Spielzeug zum Sparpreis shoppen.",
    "link": "https://www.kindermaxx.de",
    "displayed_link": "kindermaxx.de",
    "advertiser": "Kindermaxx",
    "call_to_action": "Jetzt einkaufen",
    "image": "https://tpc.googlesyndication.com/simgad/12588897089663835345",
    "logo": "https://tpc.googlesyndication.com/simgad/16705078135189463580"
  },
  ...
  ]
}