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
curl "https://posttodata.com/v1/google_ads/search?query=nike.com&limit=5" -H "Authorization: Bearer YOUR_API_KEY"
Python (requests)
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"))
TypeScript / Node.js
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);
Go
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.

Add the MCP server once
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.

200 OK — JSON Response
{
  "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