{ "openapi": "3.0.1", "info": { "title": "Google Ads Scraper: Ad Copy & Click-Through Links", "description": "Google Ads Scraper: Ad Copy & Click-Through Links extracts SERP ad dataβ€”headlines, descriptions, URLs, sitelinks & advertiser domainsβ€”for any keyword. πŸš€ Perfect for PPC research, competitor monitoring & ad copy insights. πŸ“Š Export CSV/JSON, schedule runs & automate reports.", "version": "0.1", "x-build-id": "SgIoZ31eupxBn1cwu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemesh~google-ads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemesh-google-ads-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/scrapemesh~google-ads-scraper/runs": { "post": { "operationId": "runs-sync-scrapemesh-google-ads-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/scrapemesh~google-ads-scraper/run-sync": { "post": { "operationId": "run-sync-scrapemesh-google-ads-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": [ "startUrls" ], "properties": { "startUrls": { "title": "🌐 Google Ads URLs / IDs / Keywords", "type": "array", "description": "🧩 Add one or more inputs to get started:\nβ€’ πŸ”— Google Ads Transparency profile URLs\nβ€’ πŸ†” Advertiser IDs\nβ€’ πŸ” Keywords to discover advertisers\n\nExample URL: https://adstransparency.google.com/advertiser/AR04619580580634296321", "items": { "type": "string" } }, "maxItems": { "title": "πŸ“¦ Maximum Items to Collect", "minimum": 1, "maximum": 10000, "type": "integer", "description": "βš™οΈ Set the max number of ad creatives to collect per advertiser (1-10000).", "default": 10 }, "proxyConfiguration": { "title": "πŸ›‘οΈ Proxy Configuration", "type": "object", "description": "🌍 Configure proxy settings for more reliable data collection.\n🚦 Helps reduce blocks and improve stability during larger runs." }, "openAdPreviews": { "title": "πŸ“ Read the ad's own preview", "type": "boolean", "description": "πŸ“„ Open each ad's own preview file β€” the `previewUrl` this actor already prints but never reads β€” and pull out the ad's headline, its description, its longer line, its button label and the web address it clicks through to. Plain HTTP, no browser, no login, nothing downloaded: one extra request per ad. Google archives text and search ads as flat pictures, so those ads carry no readable copy at all and come back empty rather than guessed.", "default": true }, "onlyAdsWithAdCopy": { "title": "βœ‚οΈ Only ads with readable copy", "type": "boolean", "description": "🎯 Keep only the ads whose preview actually gave up a headline or a click-through link. Google archives text and search ads as flat images, so only some of an advertiser's ads carry readable copy β€” leaving this on means your dataset is the ads you can actually read instead of a page of blanks. Turn it off to keep every ad, with empty values where Google publishes nothing.", "default": true }, "destinationDomainFilter": { "title": "πŸ”— Only these click-through links", "type": "array", "description": "🧲 Keep only ads whose click-through link contains one of these pieces of text β€” a rival's checkout host (shop.example.com), an app store (play.google.com), an affiliate network, or a campaign parameter (utm_source=). Leave empty to keep everything. Matched against the link read in this run, never against a saved list.", "items": { "type": "string" }, "default": [] }, "includePromotedProduct": { "title": "πŸ›οΈ What the ad is selling", "type": "boolean", "description": "πŸ“¦ Also return the thing the ad is promoting, when the preview says so: for app-install ads the app's name, its store id, the store, the developer, the category and the store blurb; for shopping ads the product item ids and ad-group id that already sit in the preview link; and for video ads the YouTube video the ad plays, with its length.", "default": 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 } } }, "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 } } } } } } } } } }