{ "openapi": "3.0.1", "info": { "title": "Ad Library Scraper: Meta, Google and TikTok Ads by Domain", "description": "Scrape the Meta Ad Library, Google Ads Transparency Center and TikTok Ad Library by advertiser domain or name. Every ad comes back in one normalized table: dates, format, text, media, landing page, regions and library link.", "version": "0.1", "x-build-id": "WEt0t8wiZZicaLes5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pistachio_implementation~ad-transparency-multi-library/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pistachio_implementation-ad-transparency-multi-library", "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/pistachio_implementation~ad-transparency-multi-library/runs": { "post": { "operationId": "runs-sync-pistachio_implementation-ad-transparency-multi-library", "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/pistachio_implementation~ad-transparency-multi-library/run-sync": { "post": { "operationId": "run-sync-pistachio_implementation-ad-transparency-multi-library", "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": [ "advertisers" ], "properties": { "advertisers": { "title": "Advertisers", "type": "array", "description": "Advertiser domains or names, one per line. Domains (nike.com) give the cleanest matches. You can also paste a Google advertiser ID (AR followed by digits) or a Meta page ID (digits only).", "items": { "type": "string" } }, "sources": { "title": "Ad libraries", "type": "array", "description": "Which public ad libraries to search. Leave empty for all three.", "items": { "type": "string", "enum": [ "google", "meta", "tiktok" ], "enumTitles": [ "Google Ads Transparency Center", "Meta Ad Library (Facebook and Instagram)", "TikTok Ad Library (EU, EEA, UK, CH, TR)" ] }, "default": [ "google", "meta", "tiktok" ] }, "country": { "title": "Country", "pattern": "^([A-Za-z]{2})?$", "type": "string", "description": "Two letter country code (US, GB, DE). Leave empty for all countries. The TikTok library only covers Europe, the UK, Switzerland and Turkey, so TikTok is skipped for other countries." }, "dateFrom": { "title": "Shown on or after", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Only ads shown on or after this date (YYYY-MM-DD)." }, "dateTo": { "title": "Shown on or before", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Only ads shown on or before this date (YYYY-MM-DD)." }, "maxAdsPerSource": { "title": "Max ads per advertiser per library", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stops after this many ads for each advertiser in each library. You pay per ad, so this also caps cost. Meta returns at most about 30 ads per advertiser when run on Apify, because Meta rate limits the next page; Google and TikTok go up to this cap.", "default": 50 }, "strictMatch": { "title": "Strict advertiser matching", "type": "boolean", "description": "On: keep only ads whose advertiser name contains your term, or (for domains on Meta) whose link points to your domain. Off: keep everything the library search returns.", "default": true }, "googleDetails": { "title": "Google: add regions per ad", "type": "boolean", "description": "Makes one extra request per Google ad to list every country it ran in, and to find the YouTube link for video ads. Slower.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. The libraries are public and usually work without a proxy." } } }, "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 } } } } } } } } } }