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.

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

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="
  }
}