# Google Ads Transparency Center API > Google Ads Transparency Center workflow and API: company ads. Returns ads, ad id, format and ad text as JSON. Google Ads Transparency Center data from adstransparency.google.com: company ads. - Page: https://fous.com/workflows/google-ads-transparency-center - Handle: `@google-ads-transparency-center` - Category: [Marketing](https://fous.com/workflows/category/marketing) - Source website: https://adstransparency.google.com - Last verified: Sep 29, 2026 - Fous is not affiliated with Google Ads Transparency Center. ## Methods ### Get company ads Operation `get_company_ads`, version 1. 1 credit per call. Find a verified advertiser by company name or website domain and return its Google ads with dates and ad pages. Counts may be approximate; visible copy is included when available. For large results, regions and media previews may be unavailable beyond the first 40 ads. **Input** | Field | Type | Required | Example | Description | |---|---|---|---|---| | `country` | string | no | `"United States"` | Country name or two-letter country code, for example United States or US; all means all countries. | | `ad_format` | string | no | `"video"` | Ad type to include, for example video. | | `advertiser` | string | yes | `"Nike"` | Company or brand name, or website domain, for example Nike or nike.com. | | `date_range` | string | no | `"last_7_days"` | When ads were shown, for example last_30_days. | | `max_results` | integer | no | `3` | Maximum ads to return, for example 40. | **Input schema** ```json { "type": "object", "required": [ "advertiser" ], "properties": { "country": { "type": "string", "default": "all", "description": "Country name or two-letter country code, for example United States or US; all means all countries.", "examples": [ "United States", "US" ] }, "ad_format": { "enum": [ "all", "text", "image", "video" ], "type": "string", "default": "all", "description": "Ad type to include, for example video.", "examples": [ "video", "text" ] }, "advertiser": { "type": "string", "description": "Company or brand name, or website domain, for example Nike or nike.com.", "examples": [ "Nike", "nike.com" ] }, "date_range": { "enum": [ "any_time", "last_7_days", "last_30_days" ], "type": "string", "default": "any_time", "description": "When ads were shown, for example last_30_days.", "examples": [ "last_7_days", "any_time" ] }, "max_results": { "type": "integer", "default": 40, "maximum": 200, "minimum": 1, "description": "Maximum ads to return, for example 40.", "x-fous-developer": true, "examples": [ 3, 2 ] } }, "additionalProperties": false, "examples": [ { "advertiser": "Nike", "max_results": 3 }, { "country": "United States", "ad_format": "video", "advertiser": "nike.com", "date_range": "last_7_days", "max_results": 2 }, { "country": "US", "ad_format": "text", "advertiser": "Nike", "date_range": "any_time", "max_results": 2 } ] } ``` **Output** | Field | Type | Example | Description | |---|---|---|---| | `ads` | array | | | | `ads[].ad_id` | string | `"CR08599241854849908737"` | | | `ads[].format` | string or null | `"text"` | | | `ads[].ad_text` | string or null | | | | `ads[].preview_url` | string or null | `"https://tpc.googlesyndication.com/archive/simgad/10495751636028054464"` | | | `ads[].ad_page_link` | string | `"https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR08599241854849908737"` | | | `ads[].regions_shown` | array or null | | | | `ads[].last_shown_date` | string or null | `"2026-09-29"` | | | `ads[].first_shown_date` | string or null | `"2023-11-16"` | | | `advertiser_id` | string | `"AR16735076323512287233"` | | | `advertiser_name` | string | `"Nike, Inc."` | | | `total_ads_count` | integer | `8000` | | | `matched_advertiser` | string | `"Nike, Inc."` | | | `advertiser_location` | string or null | `"United States"` | | | `advertiser_page_link` | string | `"https://adstransparency.google.com/advertiser/AR16735076323512287233"` | | **Example input** ```json { "advertiser": "Nike", "max_results": 3 } ``` **Example output** ```json { "ads": [ { "ad_id": "CR08599241854849908737", "format": "text", "ad_text": null, "preview_url": "https://tpc.googlesyndication.com/archive/simgad/10495751636028054464", "ad_page_link": "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR08599241854849908737", "regions_shown": [ "United States" ], "last_shown_date": "2026-09-29", "first_shown_date": "2023-11-16" }, { "ad_id": "CR15222418700473729025", "format": "text", "ad_text": null, "preview_url": "https://tpc.googlesyndication.com/archive/simgad/9768950093910457954", "ad_page_link": "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR15222418700473729025", "regions_shown": [ "United States" ], "last_shown_date": "2026-09-29", "first_shown_date": "2023-11-16" }, { "ad_id": "CR08228957709056081921", "format": "text", "ad_text": null, "preview_url": "https://tpc.googlesyndication.com/archive/simgad/864469401350788055", "ad_page_link": "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR08228957709056081921", "regions_shown": [ "United States" ], "last_shown_date": "2026-09-29", "first_shown_date": "2022-11-30" } ], "advertiser_id": "AR16735076323512287233", "advertiser_name": "Nike, Inc.", "total_ads_count": 8000, "matched_advertiser": "Nike, Inc.", "advertiser_location": "United States", "advertiser_page_link": "https://adstransparency.google.com/advertiser/AR16735076323512287233" } ``` ## Quick start Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys). ```bash # First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' : "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}" curl 'https://api.fous.com/v1/query' \ --fail-with-body --silent --show-error --max-time 120 \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H 'Content-Type: application/json' \ --data-raw '{ "api": "@google-ads-transparency-center", "visibility": "public", "operation": "get_company_ads", "version": 1, "input": { "advertiser": "Nike", "max_results": 3 }, "response": { "format": "json" } }' ``` ```python # Save as fous.py and run with python3 fous.py. No packages needed. # First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' import json import os import urllib.error import urllib.request api_key = os.environ.get("FOUS_API_KEY") if not api_key: raise RuntimeError("Set FOUS_API_KEY before running this example") body = json.loads("{\n \"api\": \"@google-ads-transparency-center\",\n \"visibility\": \"public\",\n \"operation\": \"get_company_ads\",\n \"version\": 1,\n \"input\": {\n \"advertiser\": \"Nike\",\n \"max_results\": 3\n },\n \"response\": {\n \"format\": \"json\"\n }\n}") request = urllib.request.Request( "https://api.fous.com/v1/query", data=json.dumps(body).encode("utf-8"), headers={ "Authorization": f"Bearer {api_key}", "Content-Type": "application/json", }, method="POST", ) try: with urllib.request.urlopen(request, timeout=120) as response: result = json.load(response) except urllib.error.HTTPError as error: raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error if result.get("success") is False: raise RuntimeError(result.get("error", {}).get("message", "Request failed")) print(json.dumps(result["data"]["output"], indent=2)) ``` ```typescript // Save as fous.mts and run with npx tsx fous.mts. // First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' const apiKey = process.env.FOUS_API_KEY; if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example"); const response = await fetch("https://api.fous.com/v1/query", { method: "POST", headers: { "Authorization": `Bearer ${apiKey}`, "Content-Type": "application/json", }, signal: AbortSignal.timeout(120_000), body: JSON.stringify({ "api": "@google-ads-transparency-center", "visibility": "public", "operation": "get_company_ads", "version": 1, "input": { "advertiser": "Nike", "max_results": 3 }, "response": { "format": "json" } }), }); type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } }; const result: ApiResult = await response.json(); if (!response.ok || result.success === false) { throw new Error(result.error?.message ?? `HTTP ${response.status}`); } if (!result.data) throw new Error("Missing API response data"); console.log(result.data.output); ``` Or describe the data in plain language: send `{"api":"@google-ads-transparency-center","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same. ## FAQ ### Is Fous affiliated with Google Ads Transparency Center? No. Fous is not affiliated with Google Ads Transparency Center. This workflow reads the public adstransparency.google.com website and returns its data. ### How much does it cost? Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit. ### Do I need a Google Ads Transparency Center account? No. You only need a Fous account. ### How current is the data? Fous gets the data from adstransparency.google.com when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026. ## Related - [Trustpilot API](https://fous.com/workflows/trustpilot.md): Trustpilot provides company ratings, reply and location details when available, recent public reviews, and company search results with ratings, review counts, categories, locations, and links. - [TikTok Creative Center API](https://fous.com/workflows/tiktok-creative-center.md): Explore publicly visible TikTok marketing trends. - [Google Patents API](https://fous.com/workflows/google-patents.md): Google Patents searches public records and provides patent details and company summaries; legal status is estimated, and citations, claims, and company breakdowns have record limits. - [Google Trends API](https://fous.com/workflows/google-trends.md): Google Trends compares relative search interest over time and by region, shows related searches and current trends, with daily peaks for seven-day views. - [Google Search API](https://fous.com/workflows/google-search.md): Google Search returns public web, image, job, event, related-question, and autocomplete results in Google’s order, with answers and details when available; results may be fewer, omit information, or be empty. - [Google Shopping API](https://fous.com/workflows/google-shopping.md): Google Shopping shows product offers, prices, ratings, delivery and store links; results vary by country and listings, totals need shown shipping, and typical ranges may be missing. - [Google News API](https://fous.com/workflows/google-news.md): Google News returns recent publisher articles, up to 100 per search, current top stories by topic, country, and language, and local stories by city or region when available. - [Google Play API](https://fous.com/workflows/google-play.md): Google Play helps people discover Android apps and games, view public listings and search results, read reviews when available by app and region, and see country-specific top charts. - [All Marketing workflows](https://fous.com/workflows/category/marketing)