{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper - Ad Creatives + Landing Pages", "description": "Scrape Google Ads Transparency Center by domain, company name, advertiser ID, or URL. Extract ad creatives, formats, and dates with optional landing page enrichment. Google Ads Transparency API alternative for competitive analysis, ad monitoring, and lead generation.", "version": "0.1", "x-build-id": "IP19x6F2JBgVX2UTg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jaybird~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jaybird-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/jaybird~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-jaybird-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/jaybird~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-jaybird-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", "required": [ "queries" ], "properties": { "queries": { "title": "Queries", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Mix of inputs — paste any combination of: domain (e.g. `nike.com`), advertiser ID (e.g. `AR16735076323512287233`), company name (e.g. `Nike Inc.`), or a full transparency center URL. The Actor auto-detects each type.", "default": [ "nike.com" ], "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "ISO 3166-1 alpha-2 country code to filter ads by where they ran (e.g. `US`, `GB`, `DE`). Use `anywhere` to include all regions.", "default": "anywhere" }, "dateRangePreset": { "title": "Date range", "enum": [ "ANYTIME", "TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_30_DAYS", "CUSTOM" ], "type": "string", "description": "Time window for ads. Google retains ~12 months of history.", "default": "LAST_30_DAYS" }, "customStartDate": { "title": "Custom start date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only used when `dateRangePreset` is `CUSTOM`. Format: YYYY-MM-DD." }, "customEndDate": { "title": "Custom end date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only used when `dateRangePreset` is `CUSTOM`. Format: YYYY-MM-DD." }, "adFormat": { "title": "Ad format", "enum": [ "ALL", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Filter by creative format.", "default": "ALL" }, "platform": { "title": "Platform", "enum": [ "ALL", "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY" ], "type": "string", "description": "Filter by where the ad was served.", "default": "ALL" }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Hard cap on how many ads to pull for each resolved advertiser. Use 0 for unlimited (within date window).", "default": 5 }, "enrichLandingPages": { "title": "Enrich landing pages", "type": "boolean", "description": "If enabled, the Actor will also fetch each ad's destination URL and extract page title, meta description, H1, and primary CTA copy. **Billed as a separate event** — leave off if you only need ad creative data.", "default": false }, "landingPageTimeoutSecs": { "title": "Landing page fetch timeout (seconds)", "minimum": 5, "maximum": 60, "type": "integer", "description": "Per-page timeout when fetching landing pages. Only used when `enrichLandingPages` is true.", "default": 15 } } }, "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 } } }, "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 } } } } } } } } } }