Logo SearchApi

Google Ads Transparency Center API Documentation

Google Ads Transparency Center API uses the /api/v1/search?engine=google_ads_transparency_center endpoint to retrieve information about advertisers and their campaigns.

Each ad creative includes an id field, which you can pass as a parameter to the Ad Details API to retrieve detailed information about the ad.

API Parameters

Search Params

  • Name
    advertiser_id
    Required
    Optional
    Description

    Specifies the advertiser's unique ID. Multiple IDs can be provided, separated by commas. Required if domain is not provided.

    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 from Google Search Page.
    • Inspect the URL from the Google Ads Transparency Center website and locate the path segment that starts with AR.

  • Name
    domain
    Required
    Optional
    Description

    Defines the advertiser's verified domain (e.g., tesla.com). Required if advertiser_id is not provided.

Filters

  • Name
    region
    Required
    Optional
    Description

    Specifies the region for your search. The default parameter is anywhere. Check the full list of supported Google Ads Transparency Center regions.

  • Name
    platform
    Required
    Optional
    Description

    Specifies the platform for which the ads are being retrieved. Accepted values include:
    google_play, google_maps, google_search, youtube, or google_shopping.

  • Name
    ad_format
    Required
    Optional
    Description

    Filters results based on ad format. Accepted values are: text, image, or video.

  • Name
    time_period
    Required
    Optional
    Description

    Limits the results to a specific time range. Accepted values are:

    today yesteday last_7_days last_30_days

    Alternatively, specify a custom range using YYYY-MM-DD..YYYY-MM-DD.

Pagination

  • Name
    next_page_token
    Required
    Optional
    Description

    A token for fetching the next set of results. You can obtain this token from the next_page_token field in the previous response

  • Name
    num
    Required
    Optional
    Description

    Specifies the number of results to return. Default is 40. The maximum is 100.

Engine

  • Name
    engine
    Required
    Required
    Description

    Specifies the search engine. Must be set to google_ads_transparency_center.

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

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?domain=tesla.com&engine=google_ads_transparency_center&time_period=last_30_days
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_ads_transparency_center",
  "domain": "tesla.com",
  "time_period": "last_30_days"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_DdeYJm72pz81t4BKo9ZEPlbV",
    "status": "Success",
    "created_at": "2025-02-21T14:51:30Z",
    "request_time_taken": 1.04,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.05,
    "request_url": "https://adstransparency.google.com/advertiser/AR17828074650563772417?region=anywhere",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_DdeYJm72pz81t4BKo9ZEPlbV.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_DdeYJm72pz81t4BKo9ZEPlbV"
  },
  "search_parameters": {
    "engine": "google_ads_transparency_center",
    "advertiser_id": "AR17828074650563772417",
    "region": "anywhere"
  },
  "search_information": {
    "total_results": 4000
  },
  "ad_creatives": [
    {
      "position": 1,
      "id": "CR03335465984256376833",
      "target_domain": "tesla.com",
      "advertiser": {
        "id": "AR17828074650563772417",
        "name": "Tesla Inc."
      },
      "first_shown_datetime": "2025-01-17T20:18:39Z",
      "last_shown_datetime": "2025-03-04T19:41:49Z",
      "total_days_shown": 46,
      "format": "video",
      "details_link": "https://adstransparency.google.com/advertiser/AR17828074650563772417/creative/CR03335465984256376833?region=anywhere",
      "details_script_link": "https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&obfuscatedCustomerId=5877708682&creativeId=729581347346&uiFeatures=12,54&adGroupId=173822809339&assets=%3DH4sIAAAAAAAAAOMy5-Lk-Hju9txJrAI8QObfpeuP32URYAYyf0GYTEDmptmPdwKZjEDmkvlr96xlEeAAALT5BOY5AAAA&sig=ACiVB_w4kdEA3MyN90cv2wgM1KClaKpNIg&htmlParentId=fletch-render-18123936258153030523&responseCallback=fletchCallback18123936258153030523"
    },
    {
      "position": 2,
      "id": "CR10302176029568925697",
      "target_domain": "tesla.com",
      "advertiser": {
        "id": "AR17828074650563772417",
        "name": "Tesla Inc."
      },
      "first_shown_datetime": "2024-10-10T21:42:07Z",
      "last_shown_datetime": "2025-03-04T19:39:45Z",
      "total_days_shown": 145,
      "format": "video",
      "details_link": "https://adstransparency.google.com/advertiser/AR17828074650563772417/creative/CR10302176029568925697?region=anywhere",
      "details_script_link": "https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&obfuscatedCustomerId=5877708682&creativeId=716611113069&uiFeatures=12,54&adGroupId=170434759089&assets=%3DH4sIAAAAAAAAAOMy5-Lk-LV0_fG7LAJMQOaS-Wv3rGUR4AAy_0JEmYHMj-duz53EKsADZG6a_XgnUJQRAFeOCyY5AAAA&sig=ACiVB_wf9DQAA4DZBdmJm9GVYGt1PWKoMQ&htmlParentId=fletch-render-3357973925771685201&responseCallback=fletchCallback3357973925771685201"
    },
    ...
  ],
  "pagination": {
    "next_page_token": "Q2dvQVA3em5SWEhxbXl2ZkVoQ1FFYXByZkc1dUY5OU1DU0FBQUFBQUdnbjgrSi9XK0wvS0Q0RT0="
  }
}