# Google Ads Transparency Center Advertiser Ads API. Ads, page by page. Advertiser's ads by format, service and date. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dgoogle.ads) ## Google Ads Transparency Center Advertiser Ads API at a glance Returns the ads one advertiser ran on Google Search, YouTube, Maps, Play and Shopping, from the Ads Transparency Center, by advertiser ID or link. Each ad has its format, image, first and last day shown and days shown, with the advertiser's name and verification. Filter by country, format, service and dates, or list only election ads, which add their countries and Google's impressions and spend ranges and sort by impressions or spend. Ads come most recently shown first. GET `/v1/google/ads` [Read the API reference](https://socialtap.dev/docs/reference/google/ads/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **20 typed fields** null when unknown - **40** ads per page, last shown, most recent first - **`handle`** is all it needs, e.g. `AR01614014350098432001` ## Send one request. Get up to 40 ads 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` `handle = AR01614014350098432001` [Open in playground](https://socialtap.dev/playground/?endpoint=google.ads) cURL: ```shell curl -G 'https://socialtap.dev/v1/google/ads' \ --data-urlencode 'handle=https://adstransparency.google.com/advertiser/AR01614014350098432001?region=US' \ -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.ads.list({ handle: "https://adstransparency.google.com/advertiser/AR01614014350098432001?region=US" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ handle: "https://adstransparency.google.com/advertiser/AR01614014350098432001?region=US", }); const res = await fetch(`https://socialtap.dev/v1/google/ads?${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, page, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/google/ads", params={"handle": "https://adstransparency.google.com/advertiser/AR01614014350098432001?region=US"}, 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, page, meta = body["data"], body["page"], 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("handle", "https://adstransparency.google.com/advertiser/AR01614014350098432001?region=US") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/google/ads?"+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"` Page json.RawMessage `json:"page"` 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": "lululemon athletica canada inc.", "id": "AR01614014350098432001", "is_verified": true, "url": "https://adstransparency.google.com/advertiser/AR01614014350098432001", "username": null }, "approximate_fields": [ "creatives" ], "audience_size": null, "country_codes": [], "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/6465019125132301667", "width": null } ], "title": null } ], "first_shown_at": "2026-10-14T00:57:35Z", "id": "CR04589531176955281409", "impressions": null, "is_active": null, "is_political": null, "languages": [], "last_shown_at": "2026-11-03T00:48:22Z", "paid_by": null, "platform": "google", "platform_specific": { "google": { "days_shown": 21, "is_synthetic": null, "product_category": null, "regions": [], "targeting": null, "topic": null } }, "publisher_platforms": [], "reach": null, "spend": null, "type": "text", "unknown_fields": [ "country_codes", "languages", "platform_specific.google.regions" ], "url": "https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR04589531176955281409" }, { "advertiser": { "avatar_url": null, "display_name": "lululemon athletica canada inc.", "id": "AR01614014350098432001", "is_verified": true, "url": "https://adstransparency.google.com/advertiser/AR01614014350098432001", "username": null }, "approximate_fields": [ "creatives" ], "audience_size": null, "country_codes": [], "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/8703432262747982451", "width": null } ], "title": null } ], "first_shown_at": "2024-08-27T09:13:20Z", "id": "CR10993845259498160129", "impressions": null, "is_active": null, "is_political": null, "languages": [], "last_shown_at": "2026-11-03T00:45:16Z", "paid_by": null, "platform": "google", "platform_specific": { "google": { "days_shown": 485, "is_synthetic": null, "product_category": null, "regions": [], "targeting": null, "topic": null } }, "publisher_platforms": [], "reach": null, "spend": null, "type": "text", "unknown_fields": [ "country_codes", "languages", "platform_specific.google.regions" ], "url": "https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR10993845259498160129" }, { "advertiser": { "avatar_url": null, "display_name": "lululemon athletica canada inc.", "id": "AR01614014350098432001", "is_verified": true, "url": "https://adstransparency.google.com/advertiser/AR01614014350098432001", "username": null }, "approximate_fields": [], "audience_size": null, "country_codes": [], "creatives": [], "first_shown_at": "2026-08-11T21:42:51Z", "id": "CR06360865746699943937", "impressions": null, "is_active": null, "is_political": null, "languages": [], "last_shown_at": "2026-11-03T00:37:13Z", "paid_by": null, "platform": "google", "platform_specific": { "google": { "days_shown": 84, "is_synthetic": null, "product_category": null, "regions": [], "targeting": null, "topic": null } }, "publisher_platforms": [], "reach": null, "spend": null, "type": "image", "unknown_fields": [ "country_codes", "creatives", "languages" ], "url": "https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR06360865746699943937" } ], "page": { "has_more": true, "next_cursor": "c1.EXAMPLE_CURSOR", "next_cursor_expires_at": "2026-10-26T12:00:00Z", "end_reason": null }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "google", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 278, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "profile", "id": "AR01614014350098432001", "url": "https://adstransparency.google.com/advertiser/AR01614014350098432001" }, "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/ads/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 advertiser: its Ads Transparency Center ID (AR…) or its page link (adstransparency.google.com/advertiser/AR…), in any case. - ### 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 Advertiser Ads API. - ### Monitor a competitor's Google ads as they launch - ### Count an advertiser's ads by format or service - ### Track a campaign's election ads, spend and reach ## Good to know before you build. - Each ad is the center's preview: the first variation's image (none for text, video and HTML5 ads), without regions, services, payer or targeting. The Google Ads Transparency Center Ad API returns those for one ad. - Impressions, spend and countries come only with election ads: topic=political lists them and needs a country. - The center filters by date only within the last year. A since older than that, or an until without since, is filtered on our side through the whole list, most recently shown first, so a page can come back empty while the walk reaches the window. Such pages are free. - is_active is null because the center shows no status: last_shown_at says when the ad last ran. ## 1 credit per page. 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/ads/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | 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 Advertiser Ads API. More in the [API reference](https://socialtap.dev/docs/reference/google/ads/index.md). **How much does the Google Ads Transparency Center Advertiser Ads API cost?** A page of up to 40 ads costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours. 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 Advertiser Ads API](https://socialtap.dev/apis/facebook/ads/index.md) (1 credit / page · `GET /v1/facebook/ads`) - [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 Ad API](https://socialtap.dev/apis/google/ad/index.md) (1 credit · `GET /v1/google/ad`) - [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/ads/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)