Skip to content

Google Ads Transparency Center Scraper API

The Ads Transparency Center loads its ad listings with JavaScript and splits them across pages, so a plain HTTP fetch rarely returns the creatives you came for.

OUTPUT FORMATSHTMLJSONMarkdown

This API takes an advertiser page or a search URL, runs the page in a headless browser, walks the pagination, and hands back the rendered HTML or parsed JSON — so your code can focus on the data rather than on browser management.

What teams collect from the Ads Transparency Center

Most transparency-center jobs fall into three buckets. Each one maps to a different slice of the page, and the request controls you pick should follow the bucket you are in.

Which request control serves which job

Use this map to pick the minimum set of parameters for your extraction goal. Each row is a reader-facing decision, not a required combination — you only send what your job needs.

Worked example: advertiser URL to JSON

A typical run looks like this. You start with an advertiser page URL from the transparency center, add render_js=true so the headless browser executes the page's JavaScript, and attach extract_rules (CSS selectors mapped to field names) or ai_extract_rules (a natural-language spec) to describe the fields you want. The response comes back as parsed JSON. If the target throttles aggressive patterns, space out requests or use multiple sessions — the API's own limits are per-plan concurrency limits, not per-target rate limits.

Two different limits, two different fixes

If requests queue up or fail before they reach the target, you are probably hitting your plan's concurrency ceiling — the fix is to raise the plan or reduce parallel workers. If requests reach the target but come back empty or throttled, the target itself is limiting you — the fix is to slow down or spread work across sessions. Treating one as the other wastes credits and time.

Plans and credits

Plans are billed monthly and include a fixed number of API credits, a concurrency allowance, JavaScript rendering, rotating and premium proxies, geotargeting, and screenshot/extraction rules. Higher tiers add priority email support, a dedicated account manager, and team management. Prices are exclusive of VAT. Credit and concurrency figures below are the captured reference values — check the pricing page for current terms before committing.

Frequently asked questions

Short answers to the questions that come up most when wiring this API into a pipeline.

Request control to extraction goal
ControlWhat it doesUse it when
render_js=trueRuns the page in a real headless browser and returns post-render HTMLThe page's ad listings only appear after JavaScript executes
country_codeRoutes the request through a residential IP in the given countryContent varies by geography and you need the local view
extract_rulesCSS selectors mapped to field names, returned as parsed JSONYou know the page structure and want typed fields
ai_extract_rulesNatural-language spec for the fields you wantThe structure is unstable or you want to describe fields in words
stealth_proxyPremium proxy routing to reduce CAPTCHA and block riskThe target is blocking plain requests

Reference values captured from the publisher's product page; confirm current behavior and pricing before relying on them.

Frequently asked questions

Can I scrape Google Ads Transparency Center without writing code?

Yes. The dashboard request builder lets you paste a URL, set parameters, and copy the generated snippet in Python, Node, Go, PHP, Ruby, or cURL.

How do I handle JavaScript when scraping Google Ads Transparency Center?

Pass render_js=true on the request. The page runs in a real headless browser, the JavaScript executes server-side, and you get the post-render HTML back.

Can I scrape Google Ads Transparency Center from a specific country?

You can. Set country_code on the request and the call exits through a residential IP located in that country. Reach for it whenever the ad set you see depends on where the viewer sits.

What's the rate limit for scraping Google Ads Transparency Center?

There is no separate per-target rate limit to configure. What you get is a concurrency allowance tied to your plan. When the target starts pushing back on fast, repetitive traffic, the practical answer is to add delay between calls or split the work across several sessions.

How do I get structured JSON from Google Ads Transparency Center?

Describe the fields you want in one of two ways: extract_rules, where you pair CSS selectors with field names, or ai_extract_rules, where you state the fields in plain language. Either way the parsed JSON comes back in the response.

Which programming languages can I use to scrape Google Ads Transparency Center?

Any. SDKs are published for Python, Node.js, Go, PHP, Ruby, and Java. Plain cURL works too. Pick whatever your stack already uses.