Google Ads Transparency Center Ad Details API

Our Google Ads Transparency Center Ad Details API allows you to scrape detailed ad information of an ad from the Google Ads Transparency Center page.

The API is accessed through the following endpoint: /search?engine=google_ads_transparency_center_ad_details. A user may query the following: https://serpapi.com/search?engine=google_ads_transparency_center_ad_details utilizing a GET request. Head to the playground for a live and interactive demo.

API Parameters

Search Query

advertiser_id

Required

Parameter defines the Google Advertiser ID. It can be found in the Ads Transparency Center advertiser URL.
For example, the advertiser ID for the URL https://adstransparency.google.com/advertiser/AR17828074650563772417 is AR17828074650563772417(Tesla Inc).

creative_id

Required

Parameter defines the Google Creative ID. It can be found in the Ads Transparency Center creative URL.
For example, the creative ID for the URL https://adstransparency.google.com/advertiser/AR17828074650563772417/creative/CR07110512387970564097 is CR07110512387970564097.

Geographic Location

region

Optional

Parameter defines from where you want the search to originate. By default it finds results from anywhere. Head to the Google Ads Transparency Center Regions for a full list of supported regions.

Serpapi Parameters

engine

Required

Set parameter to google_ads_transparency_center_ad_details to use the Google Ads Transparency Center Ad Details API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the Google Ads Transparency Center Ad Details results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

zero_trace

Optional

Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.

json_restrictor

Optional

Parameter defines the fields you want to restrict in the outputs for smaller, faster responses. See JSON Restrictor for more details.

Example with text format ad

Example with text format ad

JSON Example

{
  "search_metadata": {
    "id": "68a9b3cffc8a2b5d6a134260",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/4fd88db7dd604358/68a9b3cffc8a2b5d6a134260.json",
    "created_at": "2025-08-23 12:27:59 UTC",
    "processed_at": "2025-08-23 12:27:59 UTC",
    "google_ads_transparency_center_ad_details_url": "https://adstransparency.google.com/advertiser/AR12039459359856525313/creative/CR11382217505440268289?region=anywhere",
    "raw_html_file": "https://serpapi.com/searches/4fd88db7dd604358/68a9b3cffc8a2b5d6a134260.html",
    "prettify_html_file": "https://serpapi.com/searches/4fd88db7dd604358/68a9b3cffc8a2b5d6a134260.prettify",
    "total_time_taken": 1.15
  },
  "search_parameters": {
    "engine": "google_ads_transparency_center_ad_details",
    "advertiser_id": "AR12039459359856525313",
    "creative_id": "CR11382217505440268289"
  },
  "search_information": {
    "format": "text",
    "last_shown": 1755907200,
    "region_name": "anywhere",
    "more_ads_by_advertiser": "https://adstransparency.google.com/advertiser/AR12039459359856525313",
    "regions": [
      {
        "region": 2586,
        "region_name": "Pakistan",
        "last_shown": 1755820800
      },
      {
        "region": 2276,
        "region_name": "Germany",
        "first_shown": 1703376000,
        "last_shown": 1755561600
      },
      ...
    ]
  },
  "ad_creatives": [
    {
      "title": "Spaceship",
      "headline": "Spaceship.com Official Website - Connect Your Digital World",
      "snippet": "Propel your business into the digital frontier with Spaceship's cutting-edge web services. One seamless platform to build your online world. Start building your online presence. Secure Storage.",
      "visible_link": "www.spaceship.com/",
      "advertiser_logo": "https://tpc.googlesyndication.com/simgad/10412664068883992077?sqp=-oaymwEKCCAQICABUAFYAQ&rs=AOga4qlelohbbmX0V-_RrwDG8gamIRP8xQ",
      "advertiser_logo_alt": "Spaceship logo",
      "sitelink_texts": [
        "Free Domain Privacy",
        "Domain Name Registration",
        "Domain Price List",
        "Transfer Your Domain",
        "Business Email"
      ]
    },
    {
      "title": "Spaceship",
      "headline": "Spaceship: Find Your Domain - Connect Your Digital World",
      "snippet": "Propel your business into the digital frontier with Spaceship's cutting-edge web services. One...",
      "visible_link": "www.spaceship.com/",
      "advertiser_logo": "https://tpc.googlesyndication.com/simgad/12409841872432287465?sqp=-oaymwEKCCAQICABUAFYAQ&rs=AOga4qmrbK2mzh53wNHlyldHhcY5AZ6yZg",
      "advertiser_logo_alt": "Spaceship logo",
      "sitelink_texts": [
        "Domain Name Registration",
        ".com Domain for $8.88",
        "Domain Price List",
        "Shared Hosting",
        "Transfer Your Domain"
      ]
    }
  ]
}

Example with image format ad

Example with image format ad

JSON Example

{
  "search_metadata": {
    "id": "68a9bb5afc8a2b5d6934814d",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/4fd88db7dd604358/68a9bb5afc8a2b5d6934814d.json",
    "created_at": "2025-08-23 13:00:10 UTC",
    "processed_at": "2025-08-23 13:00:10 UTC",
    "google_ads_transparency_center_ad_details_url": "https://adstransparency.google.com/advertiser/AR12039459359856525313/creative/CR08667396801084522497?region=anywhere",
    "raw_html_file": "https://serpapi.com/searches/4fd88db7dd604358/68a9bb5afc8a2b5d6934814d.html",
    "prettify_html_file": "https://serpapi.com/searches/4fd88db7dd604358/68a9bb5afc8a2b5d6934814d.prettify",
    "total_time_taken": 1.38
  },
  "search_parameters": {
    "engine": "google_ads_transparency_center_ad_details",
    "advertiser_id": "AR12039459359856525313",
    "creative_id": "CR08667396801084522497"
  },
  "search_information": {
    "format": "image",
    "last_shown": 1755475200,
    "region_name": "anywhere",
    "more_ads_by_advertiser": "https://adstransparency.google.com/advertiser/AR12039459359856525313",
    "regions": [
      {
        "region": 2512,
        "region_name": "Oman",
        "last_shown": 1755475200
      },
      ...
    ]
  },
  "ad_creatives": [
    {
      "call_to_action": "Secure Your Website\nWith SSL",
      "snippet": "Buy SSL Certificates from $5.99 per\nyr",
      "link": "https://www.namecheap.com/security/ssl-certificates/",
      "image": "https://tpc.googlesyndication.com/archive/sadbundle/$csp%3Darchive$/9877914757584464601/1gk3e7z3rqji4.jpeg",
      "advertiser_logo": "https://tpc.googlesyndication.com/archive/sadbundle/$csp%3Darchive$/9877914757584464601/10vy4s4rdfps8.png"
    },
    {
      "call_to_action": "Namecheap SSL\nCert",
      "headline": "Open",
      "snippet": "Trusted encryption from\nthe leading CA. Get a\nreliable SSL certificate!",
      "link": "https://www.namecheap.com/security/ssl-certificates/",
      "image": "https://tpc.googlesyndication.com/archive/sadbundle/$csp%3Darchive$/5599605500568729063/2svlw8gny000y.jpeg",
      "advertiser_logo": "https://tpc.googlesyndication.com/archive/sadbundle/$csp%3Darchive$/5599605500568729063/10vy4s4rdfps8.png"
    },
    {
      "call_to_action": "Cheap SSL Certificates",
      "snippet": "Buy SSL Certificates from $5.99 per\nyr",
      "link": "https://www.namecheap.com/security/ssl-certificates/",
      "image": "https://tpc.googlesyndication.com/archive/sadbundle/$csp%3Darchive$/13639338934439812495/1gk3e7z3rqji4.jpeg",
      "advertiser_logo": "https://tpc.googlesyndication.com/archive/sadbundle/$csp%3Darchive$/13639338934439812495/1tqqm1plv9yfn.png"
    }
  ]
}

Example with video format ad

Example with video format ad

JSON Example

{
  "search_metadata": {
    "id": "68a9bc52fc8a2b5d6a134261",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/4fd88db7dd604358/68a9bc52fc8a2b5d6a134261.json",
    "created_at": "2025-08-23 13:04:18 UTC",
    "processed_at": "2025-08-23 13:04:18 UTC",
    "google_ads_transparency_center_ad_details_url": "https://adstransparency.google.com/advertiser/AR14970620332870729729/creative/CR05829691344313909249?region=anywhere",
    "raw_html_file": "https://serpapi.com/searches/4fd88db7dd604358/68a9bc52fc8a2b5d6a134261.html",
    "prettify_html_file": "https://serpapi.com/searches/4fd88db7dd604358/68a9bc52fc8a2b5d6a134261.prettify",
    "total_time_taken": 1.79
  },
  "search_parameters": {
    "engine": "google_ads_transparency_center_ad_details",
    "advertiser_id": "AR14970620332870729729",
    "creative_id": "CR05829691344313909249"
  },
  "search_information": {
    "format": "video",
    "last_shown": 1755907200,
    "region_name": "anywhere",
    "more_ads_by_advertiser": "https://adstransparency.google.com/advertiser/AR14970620332870729729",
    "regions": [
      {
        "region": 2840,
        "region_name": "United States",
        "last_shown": 1755820800
      }
    ]
  },
  "ad_creatives": [
    {
      "video_link": "https://rr2---sn-bvvbaxivnuxqjvm-a5ne.googlevideo.com/videoplayback?expire=1755983062&ei=VrypaMjzJ_-_n88Pw5rvoQY&ip=70.173.218.231&id=9ecbf84606de3352&itag=22&source=youtube&requiressl=yes&xpc=Eghovf3BOnoBAQ==&met=1755954262,&mh=WD&mm=31&mn=sn-bvvbaxivnuxqjvm-a5ne&ms=au&mv=m&mvi=2&pl=23&rms=au,au&susc=daps&obr=googlesyndication.com&ctier=L&mime=video/mp4&vprv=1&rqh=1&dur=15.092&lmt=1727743499135225&mt=1755953824&txp=5532434&sparams=expire,ei,ip,id,itag,source,requiressl,xpc,susc,obr,ctier,mime,vprv,rqh,dur,lmt&sig=AJfQdSswRgIhAMWU7zXedrTCCEmJtkLvq8MULphJMUX5d7-JASZgE6g_AiEAvKh-dV6jwU-m2w-mEpuLDVcgrUtVJqyUt4fWhdhQzPM=&lsparams=met,mh,mm,mn,ms,mv,mvi,pl,rms&lsig=APaTxxMwRQIhAI_uvAQvKS5sd9gSpWdRh8nb9SaMvNVVbkq3gXOuJxAkAiBkNNpoxSO9LKJ45ikAw4BQxSnm7861x2GDiz3WlKLsLg==",
      "video_duration": "00:00:15",
      "headline": "NVIDIA RTX AI PCs",
      "call_to_action": "Learn more",
      "snippet": "nvidia.com",
      "visible_link": "nvidia.com",
      "link": "https://www.nvidia.com/en-us/ai-on-rtx/?ncid=pa-so-yout-130297"
    }
  ]
}

JSON structure overview

{
  ...
  "search_information": {
    ...
    "format": "String - Format of the creative (e.g. 'text', 'image' and 'video')",
    "last_shown": "Integer - Timestamp of the last time ad was shown (Unix epoch format)",
    "region_name": "String - Region name of the ad",
    "more_ads_by_advertiser": "String - Link to the advertiser profile page",
    "ad_funded_by": "String - Ad funded by text",
    "regions": [
      {
        "region": "Integer - Region code",
        "region_name": "String - Region name",
        "first_shown": "Integer - Timestamp of the first time ad was shown (Unix epoch format)",
        "last_shown": "Integer - Timestamp of the last time ad was shown (Unix epoch format)",
        "times_shown": "String - Number of times the ad was shown in the region"
      },
      ...
    ]
  },
  "ad_creatives": [
    {
      "call_to_action": "String - Call to action text of the creative",
      "title": "String - Title of the creative",
      "headline": "String - Headline of the creative",
      "long_headline": "String - Detailed/Sub headline of the creative",
      "snippet": "String - Snippet of the creative",
      "visible_link": "String - Visible link of the creative",
      "link": "String - Destination link of the creative",
      "image": "String - Link to the creative image",
      "advertiser_logo": "String - Link to the advertiser logo",
      "advertiser_logo_alt": "String - Alt text of the advertiser logo",
      "sitelink_texts": "Array of strings - Site links texts of the creative",
      "sitelink_descriptions": "Array of strings - Site links descriptions of the creative",
      "video_link": "String - Link to the creative video, sometimes from a platform like YouTube",
      "raw_video_link": "String - Direct link to the video file itself",
      "video_duration": "String - Duration of the creative video",
      "thumbnail": "String - Link to the creative thumbnail",
      "height": "Integer - Height of the creative image",
      "width": "Integer - Width of the creative image",
      "channel_name": "String - Name of the YouTube channel of shown video",
      "channel_icon": "String - Link to the YouTube channel icon of shown video",
      "rating": "Float - Rating of the creative",
      "reviews": "Integer - Number of reviews of the creative",
      "reviews_link": "String - Link to the reviews page of the creative",
      "address": "String - Address of the creative (For ads like stores)",
      "is_verified": "Boolean - Returns 'true' if the advertiser is verified",
      "extensions": "Array[String] - Extra information of the creative",
      "carousel_data": [
        {
          "image": "String - Link to the carousel image",
          "image_aspect_ratio": "String - Aspect ratio of the carousel image",
          "image_headline": "String - Headline of the carousel image",
          "button_link": "String - Link to the carousel button",
          "button_text": "String - Text of the carousel button"
        },
        ...
      ],
      "images": [
        {
          "image": "String - Link to the image",
          "link": "String - Link to the image",
          "tag": "String - Tag of the image"
        },
        ...
      ],
    },
    ...
  ]
}