{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Center Scraper", "description": "Collect ads from Google's Ads Transparency Center by brand, domain or advertiser ID: ad text, landing pages, YouTube videos, run dates, regions, EU impressions and targeting.", "version": "0.1", "x-build-id": "DwFRRuRgBziHFK3cj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datatrilha~google-ads-transparency/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datatrilha-google-ads-transparency", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/datatrilha~google-ads-transparency/runs": { "post": { "operationId": "runs-sync-datatrilha-google-ads-transparency", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/datatrilha~google-ads-transparency/run-sync": { "post": { "operationId": "run-sync-datatrilha-google-ads-transparency", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchTerms": { "title": "Brands or advertiser names", "type": "array", "description": "Brand or company names, for example \"nike\". Each term is matched to the advertisers with the most ads (see \"Advertisers per term\"). A term that looks like a domain (nike.com) is searched as a domain. If the brand's accounts don't fill \"Max ads per search\", its own domain is searched too; those results can include agencies and resellers. Each ad's searchKey (advertiser:… or domain:…) shows where it came from.", "items": { "type": "string" } }, "domains": { "title": "Domains", "type": "array", "description": "Ads that point to these websites, from any advertiser (including agencies and resellers), for example nike.com. Full URLs are accepted.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "Google advertiser IDs (AR followed by digits), from the advertiser's Transparency Center URL. The most precise way to get one advertiser's ads.", "items": { "type": "string" } }, "startUrls": { "title": "Transparency Center URLs", "type": "array", "description": "Advertiser, domain or single-ad URLs copied from adstransparency.google.com. The region in each URL is used for that URL.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "region": { "title": "Region", "type": "string", "description": "Two-letter country code where the ads were shown, for example US, BR or DE. \"anywhere\" means all countries.", "default": "anywhere" }, "format": { "title": "Ad format", "enum": [ "ALL", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only ads of this format.", "default": "ALL" }, "startDate": { "title": "Shown on or after", "type": "string", "description": "YYYY-MM-DD. Only ads last shown on or after this date." }, "endDate": { "title": "Shown on or before", "type": "string", "description": "YYYY-MM-DD. Only ads first shown on or before this date." }, "maxAdsPerSearch": { "title": "Max ads per search", "minimum": 1, "type": "integer", "description": "Stop each search after this many ads. A brand name counts as one search across all its accounts. You pay only for ads returned. Ads found by more than one search are returned and charged once.", "default": 100 }, "maxAdvertisersPerTerm": { "title": "Advertisers per term", "minimum": 1, "maximum": 20, "type": "integer", "description": "Big brands run ads from several accounts (e.g. Nike, Inc. and Nike Retail BV). The matching accounts are searched in turn, most ads first, until \"Max ads per search\" is reached for the term. This caps how many accounts are tried.", "default": 5 }, "includeDetails": { "title": "Include ad details", "type": "boolean", "description": "All variations, every country the ad ran in with dates, and for ads shown in the EU the impressions range and targeting. One extra request per ad.", "default": true }, "includeAdContent": { "title": "Include ad text and links", "type": "boolean", "description": "Read the ad preview for headline, description, display URL, landing page, YouTube video and image URLs. Included in the price. Text ads that Google only shows as an image have no readable text.", "default": true }, "concurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Ads fetched in parallel, each through its own proxy IP.", "default": 4 }, "delaySecs": { "title": "Delay between requests (seconds)", "minimum": 0, "type": "number", "description": "Pause after each request to Google, per parallel worker.", "default": 0.5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google blocks an IP after a few dozen quick requests. The Actor switches IP on every block; residential proxies get blocked least.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }