{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Ad Text & Copy", "description": "Get every Google ad of a competitor from the Ads Transparency Center, with the ad copy as text: headline, description, display URL, app and Shopping product. Search by brand, website or advertiser ID; dates, regions, EU impressions, only-new monitoring.", "version": "0.1", "x-build-id": "XGOzsHWQHobY7K9Y0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/robertosan16~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-robertosan16-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/robertosan16~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-robertosan16-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/robertosan16~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-robertosan16-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": { "queries": { "title": "Brands, websites or links", "type": "array", "description": "Brand names (Nike), websites (nike.com), advertiser IDs (AR…) or Ads Transparency Center links, one per line. A website returns every ad that points to it, from any advertiser account; a brand name is matched to the advertiser accounts with that name.", "items": { "type": "string" } }, "domains": { "title": "Websites", "type": "array", "description": "Websites such as nike.com. Same as entering them above.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "Advertiser IDs that start with AR, from the advertiser's Transparency Center link.", "items": { "type": "string" } }, "startUrls": { "title": "Transparency Center links", "type": "array", "description": "Links to advertiser pages, ad pages or website searches on adstransparency.google.com.", "items": { "type": "string" } }, "resultType": { "title": "What to return", "enum": [ "ads", "advertisers" ], "type": "string", "description": "Ads: one row per ad. Advertisers: one row per advertiser account, with its ad count; for a website, the accounts that run ads for it.", "default": "ads" }, "region": { "title": "Region", "type": "string", "description": "Country where the ads were shown: a two-letter code (US, GB, DE, IN…) or ANYWHERE for all countries.", "default": "US" }, "platforms": { "title": "Platforms", "type": "array", "description": "Only ads shown on these Google platforms. Empty for all. Google applies this filter to ads shown since September 2023.", "items": { "type": "string", "enum": [ "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY" ], "enumTitles": [ "Google Search", "YouTube", "Google Shopping", "Google Maps", "Google Play" ] } }, "adFormat": { "title": "Ad format", "enum": [ "ALL", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only ads of this format.", "default": "ALL" }, "startDate": { "title": "Shown since", "type": "string", "description": "Only ads shown on or after this date." }, "endDate": { "title": "Shown until", "type": "string", "description": "Only ads shown on or before this date." }, "maxAdsPerSearch": { "title": "Max ads per brand, website or advertiser", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Ads to save for each entry (for a brand name, for each matching advertiser).", "default": 100 }, "maxAdvertisersPerQuery": { "title": "Advertisers per brand name", "minimum": 1, "maximum": 10, "type": "integer", "description": "A brand name can match several advertiser accounts; the ones with the most ads come first.", "default": 1 }, "includeAdText": { "title": "Ad text", "type": "boolean", "description": "Read the ad's headline, description, display URL, app and product from its preview. Google shows many text ads only as a picture; those keep the picture link and no text.", "default": true }, "includeDetails": { "title": "Details: variations, countries and impressions", "type": "boolean", "description": "One more request per ad: every variation of the ad, each country it ran in with first and last dates, and for ads shown in the EU, impressions per country and platform. Also finds ad text in variations.", "default": false }, "onlyNewAds": { "title": "Only new ads", "type": "boolean", "description": "Save only ads that earlier runs with the same memory name have not saved. Schedule the Actor daily or weekly to get just the new ads of your competitors.", "default": false }, "monitorStoreName": { "title": "Memory name", "type": "string", "description": "Name of the key-value store that remembers saved ads for Only new ads. Use one name per monitoring task.", "default": "ads-transparency-seen" }, "maxItems": { "title": "Max results in total", "minimum": 0, "type": "integer", "description": "Stop after this many results in the whole run. 0 for no limit.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy datacenter addresses work well; the Actor moves to a new address when Google asks for a check.", "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 } } } } } } } } } }