Google Ads Transparency Scraper - Full Ad Text & Creatives
Pricing
from $0.59 / 1,000 ads
See competitors' Google ads with the content itself: headline, description, display URL, images, YouTube videos, landing domain, dates, regions and platforms. Search by advertiser or domain. $0.95 per 1,000 ads.
You can access the Google Ads Transparency Scraper - Full Ad Text & Creatives programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.1", "x-build-id": "xnA7Mdaxa8KzczgKs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/plotpointtech~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-plotpointtech-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/plotpointtech~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-plotpointtech-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/plotpointtech~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-plotpointtech-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": { "advertisers": { "title": "Advertisers (names or IDs)", "type": "array", "description": "Advertiser names (e.g. \"Nike, Inc.\") or advertiser IDs starting with AR (e.g. AR16735076323512287233). You can also paste a Transparency Center advertiser URL. Names are matched to the closest advertiser in Google's search suggestions.", "items": { "type": "string" } }, "domains": { "title": "Domains", "type": "array", "description": "Find ads that point to a website, e.g. expedia.com. Returns ads from every advertiser that advertises this domain.", "items": { "type": "string" } }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser / domain", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of ads to return for each advertiser or domain.", "default": 20 }, "region": { "title": "Region", "type": "string", "description": "Two-letter country code where the ads were shown (US, GB, DE, FR, IN ...), or \"anywhere\".", "default": "anywhere" }, "platform": { "title": "Platform", "enum": [ "ANY", "SEARCH", "YOUTUBE", "MAPS", "PLAY", "SHOPPING" ], "type": "string", "description": "Only ads shown on this Google platform.", "default": "ANY" }, "format": { "title": "Ad format", "enum": [ "ANY", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only ads of this format.", "default": "ANY" }, "startDate": { "title": "Shown on or after", "type": "string", "description": "Only ads shown in this date range (YYYY-MM-DD). Leave empty for all available dates." }, "endDate": { "title": "Shown on or before", "type": "string", "description": "End of the date range (YYYY-MM-DD)." }, "fetchAdContent": { "title": "Extract ad content", "type": "boolean", "description": "Render each ad's preview to extract the headline, description, display URL, destination URL, images and YouTube video IDs. Turn off for a faster, metadata-only run.", "default": true }, "ocrTextAds": { "title": "Read archived text ads with OCR", "type": "boolean", "description": "Google keeps many search text ads only as an image of the rendered ad. When on, the actor reads the headline, description and display URL from that image with OCR (marked textSource = ocr_archived_image).", "default": true }, "ocrLanguage": { "title": "OCR language", "enum": [ "auto", "eng", "deu", "fra", "spa", "ita", "por", "nld", "pol", "tur", "rus", "jpn", "chi_sim", "kor", "eng+deu", "eng+fra", "eng+spa" ], "type": "string", "description": "Language of the text ads, for OCR. 'auto' uses English plus the main language of the selected region (e.g. German for DE). Combine with + for mixed sets, e.g. eng+deu.", "default": "auto" }, "includeRegionDetails": { "title": "Include per-region details", "type": "boolean", "description": "Add the list of regions where each ad was shown, with last-shown dates (and first-shown dates, impression ranges and platforms where Google publishes them, mainly EU/UK).", "default": true }, "detectPlatforms": { "title": "Detect platforms", "type": "boolean", "description": "Label each ad with the Google platforms it ran on (Search, YouTube, Maps, Play, Shopping) by cross-checking the platform-filtered ad lists. Adds a few extra requests per advertiser.", "default": true }, "maxVariantsToRender": { "title": "Max variants to render per ad", "minimum": 1, "maximum": 10, "type": "integer", "description": "Many ads have several variants. Stop after rendering this many if text has been found.", "default": 2 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 6, "type": "integer", "description": "Ads processed in parallel. Kept low to stay polite.", "default": 4 } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Google Ads Transparency Scraper - Full Ad Text & Creatives from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: