COMPANY AI DEVELOPER TOOLS API MCP READY

Google Ads Transparency API

List any advertiser's ads from the Google Ads Transparency Center as structured JSON: ad format, first and last shown dates, total days running, and a preview link. Competitor ad library for growth teams, agencies, and AI marketing agents. Pay per ad, MCP-ready.

MEDIAN LAGon demand

PARAMETERS4

TOTAL USERS9

MONTHLY ACTIVE8

TOTAL RUNS24

RUNS SUCCEEDED100.0%

RATING5.0 (1)

Input parameters

PARAMETER	TYPE	REQ	DEFAULT	DESCRIPTION
advertiserId	string	no	—	Enter a single advertiser ID.
advertiserIds	string[]	no	—	Provide a list of advertiser IDs (AR... codes) to fetch in one run.
region	string	no	—	Optionally limit ads to a region.
maxResultsPerAdvertiser	integer	no	50	How many ads to return per advertiser. — drives your bill

Worked examples

Basic — the required input, with the schema's own example values

{
  "advertiserId": "AR01614014350098432001",
  "advertiserIds": [
    "example"
  ]
}

Tasks

Saved runs with the inputs already filled in — each one a standalone page and a working configuration example.

Request a task →

Code

curl

curl -X POST "https://api.apify.com/v2/acts/johnvc~google-ads-transparency-api/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"advertiserId": "AR01614014350098432001", "advertiserIds": ["example"]}'

Python

from apify_client import ApifyClient

client = ApifyClient("APIFY_TOKEN")
run = client.actor("johnvc/google-ads-transparency-api").call(
    run_input={'advertiserId': 'AR01614014350098432001', 'advertiserIds': ['example']}
)
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)