Answers / Google Ads Transparency
How can I search advertiser creatives with the Google Ads Transparency API?
Call GET /v1/google_ads/search?query=DOMAIN_NAME (e.g. nike.com) with Authorization: Bearer YOUR_API_KEY. PostToData queries the public Google Ads Transparency Center and returns recent ad creatives, formats (text, image, video), and first/last shown dates.
Google Ads Transparency · search posts · $0.006 a call · one verified website trial · updated 2026-11-13
Run it live
Calls run only when you press Run. Opening this page does not spend credit.
Loading…
Search requires a company domain such as nike.com, not keywords. Detail requires a full adstransparency.google.com advertiser/creative URL. Lists never auto-expand details. Dates may be null; detail OCR is best-effort. No campaign performance or login-only ads.
Your results will appear here. Choose a platform and action, then press Run.
Real API calls require verification for one trial, or a signed-in account with prepaid credit.
From code
curl "https://posttodata.com/v1/google_ads/search?query=nike.com&limit=5" -H "Authorization: Bearer YOUR_API_KEY"import requests
r = requests.get(
"https://posttodata.com/v1/google_ads/search",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"query": "nike.com", "limit": 5},
)
for item in r.json()["data"]["items"]:
print(item["url"], item.get("text") or item.get("title"))const url = new URL("https://posttodata.com/v1/google_ads/search");
url.searchParams.set("query", "nike.com");
url.searchParams.set("limit", "5");
const res = await fetch(url, {
headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await res.json();
console.log(data.data.items);req, _ := http.NewRequest("GET", "https://posttodata.com/v1/google_ads/search?query=nike.com&limit=5", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)From your AI
Claude and ChatGPT clients that support OAuth can sign in without pasting a key. Follow the client setup guide. The command below is the API-key option for Claude Code.
claude mcp add --transport http posttodata https://posttodata.com/mcp --header "Authorization: Bearer YOUR_API_KEY"Then ask
“Search Google Ads Transparency Center for 'nike.com' using PostToData and summarize their active ad formats and messaging.”
The model calls search_posts with platform google_ads.
Response Schema & Data Sample
Normalized JSON output structure returned by PostToData. All fields are strongly typed; missing upstream metrics return null rather than being omitted.
{
"meta": {
"platform": "google_ads",
"action": "search",
"total_items": 1,
"currency": "USD",
"price_usd": "0.006"
},
"data": {
"items": [
{
"id": "nike.com",
"type": "ad",
"url": "https://google_ads.com/example_id",
"published_at": "2026-11-15T12:00:00Z",
"title": "nike.com insights & discussion",
"text": "Structured body content retrieved from the public social post, ready for AI indexing or sentiment analysis.",
"author": {
"id": "creator_01",
"username": "creator_name",
"name": "Creator",
"url": null
},
"metrics": {
"likes": 215,
"comments": 34,
"shares": 12,
"views": 5400,
"score": null
}
}
]
}
}Good to know
- Google Ads searches list at $0.006 per call.
- Query by advertiser domain name (e.g. example.com) for highest precision.
- Returns ad creative text, format type (text/image/video), and campaign date ranges.
Full reference in the docs. All Google Ads Transparency endpoints are on the Google Ads Transparency API page.
More answers