{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Ad Copy & Landing Pages", "description": "Scrape any advertiser's Google ads from the Ads Transparency Center: real headlines and descriptions, landing pages, YouTube video IDs, images, countries shown and first/last seen dates. Search by brand, domain or advertiser ID, or run it as a competitor monitor that returns only new ads.", "version": "0.2", "x-build-id": "VJqo50OZWfIh9FyNA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rimulabs~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rimulabs-google-ads-transparency-scraper", "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/rimulabs~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-rimulabs-google-ads-transparency-scraper", "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/rimulabs~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-rimulabs-google-ads-transparency-scraper", "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 domains", "type": "array", "description": "Brand names (e.g. \"HubSpot\") or domains (e.g. \"nike.com\"). A brand name is matched to its verified advertisers. A domain returns every ad that points to that domain, whoever ran it.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "Transparency Center advertiser IDs, which start with AR (shown in advertiser page URLs).", "items": { "type": "string" } }, "startUrls": { "title": "Transparency Center URLs", "type": "array", "description": "Paste advertiser, creative or domain URLs from adstransparency.google.com. A ?region= parameter in the URL is ignored in favour of the Region setting below.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "mode": { "title": "What to return", "enum": [ "ads", "advertisers" ], "type": "string", "description": "\"Advertisers only\" resolves brand names to advertiser IDs, ad counts and countries without scraping ads.", "default": "ads" }, "region": { "title": "Region", "type": "string", "description": "Two-letter country code where the ads were shown (US, GB, DE, AU, NZ, ...), or \"anywhere\".", "default": "anywhere" }, "adFormat": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only return ads of this format.", "default": "all" }, "dateFrom": { "title": "Shown from", "type": "string", "description": "Only ads shown on or after this date. Google keeps this filter for recent dates (roughly the last year)." }, "dateTo": { "title": "Shown until", "type": "string", "description": "Only ads shown on or before this date." }, "maxAdsPerTarget": { "title": "Max ads per brand, domain or advertiser", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stops after this many ads for each target. Large advertisers run tens of thousands of ads.", "default": 100 }, "includeDetails": { "title": "Include ad copy & details", "type": "boolean", "description": "Adds the ad copy (headline, description, display URL), landing page and call to action where Google provides them, YouTube video IDs, images, number of variations and every country the ad ran in. Charged as an extra \"ad details\" event per ad.", "default": true }, "extractAdText": { "title": "Read search-ad text from images (OCR)", "type": "boolean", "description": "Google stores most search (text) ads only as a picture of the ad. With this on, the Actor reads the headline, description, display URL and sitelinks from that picture (OCR, best for English and other Latin-script ads). Needs \"Include ad copy & details\". No extra charge.", "default": true }, "onlyNewAds": { "title": "Monitor mode: only return new ads", "type": "boolean", "description": "Remembers every ad returned before and only returns (and charges for) ads that are new since the last run. Schedule it daily or weekly to get a feed of competitors' new ads.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional name for the monitor's memory, e.g. \"competitors-us\". Use a different name for each set of competitors. If empty, a name is derived from your targets and filters." }, "maxAdvertisersPerTerm": { "title": "Advertisers per brand name", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many matching advertisers to use for each brand name (brands often run ads from several verified accounts).", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Datacenter proxies work well. Google rate-limits single IPs, so keep a proxy on for runs of more than a few hundred ads.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }