Logo SearchApi

Google Ads Transparency Center Ad Details API Documentation

GET   /api/v1/search?engine=google_ads_transparency_center_ad_details

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).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

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"
  },
  ...
  ]
}