Google Ads Transparency Scraper

Ad Intelligence

Operated by Sourcelane✓ verified

A scraper that queries Google’s Ads Transparency Center to collect an advertiser’s full creative library across Google surfaces (Search, YouTube, Display, Shopping, Maps, Play). It locates advertisers by keyword, domain, or stable advertiser identifier, resolves brand matches and domain-to-advertiser mappings, and returns structured creative records including advertiser identity, creative identifiers, creative format (text/image/video and format code), run date ranges and approximate days active, direct asset URLs (image, video, rich-media iframe and preview endpoints), regional serving information and per-region last-seen dates (when detailed enrichment is enabled), and provenance metadata. Supports region-level filtering (ISO country codes or global), ad-format filtering, date-range filtering, auto-pagination for large result sets, and an optional per-creative detailed fetch to populate global rollout/service maps.

Verified Sep 28, 12:10 AM

$0.0005

per result

Up to 100 per call. Only pay for results returned; failed calls are refunded.

What people use it for

Competitor ad intelligence: monitor every Google ad competitors run, with dates, formats, and regions
Ad creative research: pull a brand’s full ad library to study messaging, hooks, and visual direction
Affiliate and partner compliance: audit affiliates running paid Google traffic against a brand
Influencer and merchant vetting: verify advertiser identity, domain ownership, and ad volume before deals
Market and trend research: track creative volume and regional rollout for advertisers over time
SEO and PPC analysis: identify domains bidding alongside specific keywords or in specific countries

Trust & reliability

7d uptime trend

Window	Uptime	Success rate	p50	p95
24h	—	—	—	—
7d	—	—	—	—
30d	—	—	—	—

Calling contract

Call it through Sourcelane's gateway or MCP server. We run the connector, apply your agent's spend guardrails, and bill only the results returned.

Call it via Sourcelane

curl -X POST https://cool-puffin-608.convex.site/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"google-ads-transparency-scraper","params":{"searchQuery":"shein.com","maxResults":5},"maxResults":10}'

Request params

Field	Type	Required	Description
`searchQuery`	string	required	Keyword, domain (e.g. 'shein.com'), or advertiser ID (e.g. 'AR07816964328396947457'). Type is auto-detected unless overridden below.
`searchType`	string	optional	Force a specific interpretation of the search query. 'auto' detects from the input shape.
`region`	string	optional	ISO 2-letter country code (e.g. 'US', 'GB', 'DE') or 'anywhere' for worldwide. 237 countries supported.
`format`	string	optional	Filter by creative format.
`maxResults`	integer	optional	Maximum ads to return in this run. Set to 0 for unlimited (auto-paginates until exhausted or connector times out). Capped at 100 per call.
`dateFrom`	string	optional	Only keep ads last shown on or after this date (YYYY-MM-DD). Optional.
`dateTo`	string	optional	Only keep ads last shown on or before this date (YYYY-MM-DD). Optional.
`fetchDetailedInfo`	boolean	optional	If enabled, makes an additional request per ad to fetch the full list of regions where it ran and the per-region last-shown date. Slower and uses more proxy bandwidth, but enriches every record with regionsServed and lastShownPerRegion.
`pageId`	string	optional	Paste NEXT_PAGE_ID from the previous run's Key-value store to fetch the next page.

Each result contains

Field	Type	Description
`advertiserId`	string	Advertiser Id
`advertiserName`	string	Advertiser Name
`advertiserDomain`	string	Advertiser Domain
`creativeId`	string	Creative Id
`format`	string	Format
`formatCode`	integer	Format Code
`firstShown`	string	First Shown
`lastShown`	string	Last Shown
`approxDaysShown`	integer	Approx Days Shown
`adUrl`	string	Ad Url
`imageUrl`	null	Image Url
`videoUrl`	null	Video Url
`iframeUrl`	null	—
`previewUrl`	string	—
`contentJsUrl`	string	—
`regionsServed`	array	—
`lastShownPerRegion`	object	—
`searchQuery`	string	—
`searchRegion`	string	—
`scrapedAt`	string	—

Use Google Ads Transparency Scraper from Claude, ChatGPT or Cursor

Pick your tool and connect in under a minute. Then just ask — for example: “What ads is Shein running right now on Meta and Google? Group them by offer.”

Connect Claude

Web, desktop and mobile. Paste one URL.

1Copy your personal connector URL
2In Claude open Settings → Connectors → Add custom connector
3Paste the URL and click Add — done

Manual setup (config files, REST, Python) +

Claude Code

Adds the Sourcelane MCP server with your key as a header.

terminal

claude mcp add --transport http sourcelane https://cool-puffin-608.convex.site/mcp \
  --header "Authorization: Bearer sl_live_your_agent_key"

Claude Desktop (config file)

Alternative to the connector URL: add to claude_desktop_config.json, then restart Claude.

claude_desktop_config.json

{
  "mcpServers": {
    "sourcelane": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cool-puffin-608.convex.site/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

Cursor & Windsurf

Add to ~/.cursor/mcp.json (or Windsurf's mcp_config.json).

mcp.json

{
  "mcpServers": {
    "sourcelane": {
      "url": "https://cool-puffin-608.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

VS Code

Save as .vscode/mcp.json. VS Code prompts for your key once.

.vscode/mcp.json

{
  "servers": {
    "sourcelane": {
      "type": "http",
      "url": "https://cool-puffin-608.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sourcelane-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "sourcelane-key",
      "description": "Sourcelane agent key",
      "password": true
    }
  ]
}

ChatGPT Custom GPT (Actions)

Create a GPT → Actions → Import from URL, then Authentication: API Key, Bearer.

OpenAPI schema URL

https://sourcelane-amber.vercel.app/openapi.json

REST

One POST. Pass maxResults to cap cost.

curl

curl -X POST https://cool-puffin-608.convex.site/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"google-ads-transparency-scraper","params":{"searchQuery":"shein.com","maxResults":5},"maxResults":10}'

Python, LangChain, CrewAI, OpenAI Agents SDK…

Wrap the REST call as a tool, or point an MCP client at the endpoint.

python

import requests

res = requests.post(
    "https://cool-puffin-608.convex.site/v1/call",
    headers={"Authorization": "Bearer sl_live_your_agent_key"},
    json={
        "listing": "google-ads-transparency-scraper",
        "params": {"searchQuery":"shein.com","maxResults":5},
        "maxResults": 10,
    },
    timeout=300,
)
body = res.json()
print(body["receipt"]["chargedMicros"], "micro-USD for", body["receipt"]["results"], "results")
print(body["data"])

Reviews

—

0 reviews

Leave a review

Loading reviews…