# Google Ads Transparency Center Ad API. Send an ad link or ID. Advertiser, creative and where and when it ran. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dgoogle.ad) ## Google Ads Transparency Center Ad API at a glance Returns one ad from Google's public Ads Transparency Center by its link or creative ID, with its advertiser, creative and where and when it ran. You also get whether the advertiser verified its identity, who paid, the format, each variation's image (or a local text ad's headline, description and link), the first and last day shown, the countries and the topic Google labels it with. Ads shown in Europe and election ads add Google's impressions per country and per service and the kinds of audience criteria used. Election ads also add their spend range and age, gender and location targeting. GET `/v1/google/ad` [Read the API reference](https://socialtap.dev/docs/reference/google/ad/index.md) - **1 credit** per request, $0.75–$1.97 per 1,000 requests - **20 typed fields** null when unknown - **`url`** is all it needs, e.g. `https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR07443539616616939521?region=US` - **100 credits** free when you sign up, no card, so you can build before you spend ## Send one request. Get 20 fields back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `url = https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR07443539616616939521?region=US` [Open in playground](https://socialtap.dev/playground/?endpoint=google.ad) cURL: ```shell curl -G 'https://socialtap.dev/v1/google/ad' \ --data-urlencode 'url=https://adstransparency.google.com/advertiser/AR07541154843046445057/creative/CR17778900238552006657?region=US&topic=political' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.google.ad.get({ url: "https://adstransparency.google.com/advertiser/AR07541154843046445057/creative/CR17778900238552006657?region=US&topic=political" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ url: "https://adstransparency.google.com/advertiser/AR07541154843046445057/creative/CR17778900238552006657?region=US&topic=political", }); const res = await fetch(`https://socialtap.dev/v1/google/ad?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/google/ad", params={"url": "https://adstransparency.google.com/advertiser/AR07541154843046445057/creative/CR17778900238552006657?region=US&topic=political"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, meta = body["data"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("url", "https://adstransparency.google.com/advertiser/AR07541154843046445057/creative/CR17778900238552006657?region=US&topic=political") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/google/ad?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": { "advertiser": { "avatar_url": null, "display_name": "Republican National Committee", "id": "AR07541154843046445057", "is_verified": true, "url": "https://adstransparency.google.com/advertiser/AR07541154843046445057", "username": null }, "approximate_fields": [ "platform_specific.google.regions[].first_shown_at", "platform_specific.google.regions[].last_shown_at" ], "audience_size": null, "country_codes": [ "US" ], "creatives": [ { "body": null, "cta_text": null, "link_description": null, "link_url": null, "media": [ { "alt_text": null, "duration_ms": null, "expires_at": null, "height": null, "thumbnail_url": null, "type": "image", "url": "https://tpc.googlesyndication.com/archive/simgad/18242167605449878359", "width": null } ], "title": null } ], "first_shown_at": "2026-06-05T21:52:15Z", "id": "CR17778900238552006657", "impressions": { "lower_bound": 500000, "upper_bound": 600000 }, "is_active": null, "is_political": true, "languages": [], "last_shown_at": "2026-06-24T19:04:54Z", "paid_by": null, "platform": "google", "platform_specific": { "google": { "days_shown": 20, "is_synthetic": false, "product_category": null, "regions": [ { "country_code": "US", "first_shown_at": "2026-06-05T00:00:00Z", "impressions": { "lower_bound": 500000, "upper_bound": 600000 }, "last_shown_at": "2026-06-24T00:00:00Z", "services": [] } ], "targeting": { "age_ranges": [ "25-34", "35-44", "45-54" ], "criteria": [], "excluded_age_ranges": [ "18-24" ], "excluded_genders": [], "excluded_locations": [ { "country_code": "SC", "criterion_id": "2690", "full_name": "Seychelles", "name": "Seychelles" }, { "country_code": "CV", "criterion_id": "2132", "full_name": "Cabo Verde", "name": "Cabo Verde" }, { "country_code": "CH", "criterion_id": "2756", "full_name": "Switzerland", "name": "Switzerland" } ], "genders": [ "male", "female", "unknown" ], "locations": [ { "country_code": "US", "criterion_id": "2840", "full_name": "United States", "name": "United States" } ] }, "topic": null } }, "publisher_platforms": [], "reach": null, "spend": { "currency": "USD", "lower_bound": 5000, "upper_bound": 6000 }, "type": "image", "unknown_fields": [ "languages", "publisher_platforms" ], "url": "https://adstransparency.google.com/advertiser/AR07541154843046445057/creative/CR17778900238552006657" }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "google", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 420, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "ad", "id": "CR17778900238552006657", "url": "https://adstransparency.google.com/advertiser/AR07541154843046445057/creative/CR17778900238552006657" }, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 4 platforms. The [response reference](https://socialtap.dev/docs/reference/google/ad/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/ad/index.md). - ### Null means unknown A field Google Ads Transparency Center doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts The ad's Google Ads Transparency Center link (adstransparency.google.com/advertiser/AR…/creative/CR…), its old political ads report link, or its creative ID (CR…). - ### Write one parser Google Ads Transparency Center, TikTok Ad Library, Facebook Ad Library and LinkedIn Ad Library answer in these fields, so the code that reads one reads them all. - **`platform`string**: Library owner's platform ID (facebook for Meta's library, tiktok, google, linkedin). - **`id`string**: Library ad ID (string). - **`url`string**: Public library page of the ad. - **`advertiser`object**: The advertising page, business or account. - **`paid_by`string**: Disclosed payer ("Paid for by"). - **`is_active`boolean**: True while the ad is running. - **`first_shown_at`string**: First delivery, RFC 3339 UTC (often date-only: see approximate_fields). - **`last_shown_at`string**: Last delivery, RFC 3339 UTC; null while active. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the Google Ads Transparency Center Ad API. - ### See where a competitor's Google ad ran - ### Audit election ad spend and targeting - ### Get full detail for ads found by search ## Good to know before you build. - Image ads, and text ads Google shows as an image, return each variation's image without its size. A text ad the center draws by script (a local or Maps ad) returns one variation's headline, description and link. Video and HTML5 variations come without their media. - is_active is null because the center shows no status: last_shown_at says when the ad last ran. - Impressions are Google's ranges, disclosed for ads shown in Europe and election ads. Spend is disclosed only for election ads. ## 1 credit per request. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/google/ad/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful request | Per 1,000 requests | | --- | --- | --- | | Platform API `api` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the Google Ads Transparency Center Ad API. More in the [API reference](https://socialtap.dev/docs/reference/google/ad/index.md). **Does it include YouTube ads?** Yes. The center lists ads Google showed on Search, YouTube, Maps, Play and Shopping, and where Google discloses impressions it splits them by service. **How much does the Google Ads Transparency Center Ad API cost?** A request costs 1 credit. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. Other platforms ## Ads on 3 more platforms. - [TikTok Ad Library Ad API](https://socialtap.dev/apis/tiktok/ad/index.md) (1 credit · `GET /v1/tiktok/ad`) - [Facebook Ad Library Ad API](https://socialtap.dev/apis/facebook/ad/index.md) (1 credit · `GET /v1/facebook/ad`) - [LinkedIn Ad Library Ad API](https://socialtap.dev/apis/linkedin/ad/index.md) (1 credit · `GET /v1/linkedin/ad`) More Google Ads Transparency Center ## Google Ads Transparency Center API. 6 endpoints, one key. - [Google Ads Transparency Center Advertiser API](https://socialtap.dev/apis/google/advertiser/index.md) (1 credit · `GET /v1/google/advertiser`) - [Google Ads Transparency Center Advertiser Search API](https://socialtap.dev/apis/google/search_advertisers/index.md) (1 credit / page · `GET /v1/google/search_advertisers`) - [Google Ads Transparency Center Advertiser Ads API](https://socialtap.dev/apis/google/ads/index.md) (1 credit / page · `GET /v1/google/ads`) - [Google Ads Transparency Center Ads by Website API](https://socialtap.dev/apis/google/search_ads/index.md) (1 credit / page · `GET /v1/google/search_ads`) - [Google Ads Transparency Center Search Suggestions API](https://socialtap.dev/apis/google/search_suggestions/index.md) (1 credit / page · `GET /v1/google/search_suggestions`) ## Try it on a link you already have. Paste it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/google/ad/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)