{ "openapi": "3.0.1", "info": { "title": "Adlibrary Scraper", "description": "Gets all adlibrary.com ads results including reach and creative (without account and without cookie). \nResults are combined ads and statistics from all social media platforms adlibrary.com supports (currently Meta and Google, so all Ads across Instagram, Facebook, Threads, Whatsapp, Google, Youtube)", "version": "0.0", "x-build-id": "0bL5avg8soL0Vqvdt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bockmurat~adlibrary-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bockmurat-adlibrary-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/bockmurat~adlibrary-scraper/runs": { "post": { "operationId": "runs-sync-bockmurat-adlibrary-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/bockmurat~adlibrary-scraper/run-sync": { "post": { "operationId": "run-sync-bockmurat-adlibrary-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": [ "query" ], "properties": { "query": { "title": "Search Query", "minLength": 1, "maxLength": 500, "type": "string", "description": "The search term or phrase to look for in ads (e.g., 'fitness supplements', 'crypto trading')", "default": "fitness supplements" }, "platforms": { "title": "Platforms", "uniqueItems": true, "type": "array", "description": "Which advertising platforms to search", "items": { "type": "string", "enum": [ "meta", "google" ] }, "default": [ "meta" ] }, "pageSize": { "title": "Page Size", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Number of ads per page (max 1000)", "default": 50 }, "desiredAdvertisers": { "title": "Desired Advertisers", "minimum": 1, "maximum": 200, "type": "integer", "description": "Target number of unique advertisers to fetch (max 200)", "default": 50 }, "limit": { "title": "Total Results Limit", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum total number of ads to retrieve (max 1000)", "default": 500 }, "exactMatch": { "title": "Exact Match", "type": "boolean", "description": "Use exact phrase matching instead of keyword matching", "default": false }, "dateRange": { "title": "Date Range", "type": "object", "description": "Filter ads by delivery date range (use YYYY-MM-DD format)", "properties": { "start": { "title": "Start Date", "type": "string", "description": "Start date (YYYY-MM-DD)" }, "end": { "title": "End Date", "type": "string", "description": "End date (YYYY-MM-DD)" } } }, "adType": { "title": "Ad Type", "enum": [ "all", "political_and_issue_ads", "political", "issue", "housing", "employment", "credit" ], "type": "string", "description": "Filter by ad type" }, "targetLocation": { "title": "Target Location", "pattern": "^[A-Z]{2}$", "type": "string", "description": "Filter by geographic targeting (country code, e.g., 'US', 'DE', 'GB')" }, "filters": { "title": "Additional Filters", "type": "object", "description": "Advanced filtering options (JSON format). Example: {\"adSpendRange\": [100, 5000], \"estimatedCpm\": 2.5, \"industry\": \"technology\", \"countries\": [\"US\", \"CA\", \"GB\"]}" } } }, "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 } } } } } } } } } }