{ "openapi": "3.0.1", "info": { "title": "LinkedIn Ads Library Scraper - No Cookies", "description": "Search the LinkedIn Ad Library by keyword or by advertiser and export every single ad with its headline, body copy, format, media and destination link. See exactly which campaigns your competitors are running now, and build creative swipe files for your paid social team, with no login needed.", "version": "1.0", "x-build-id": "5GL4cFRKF3AUlqOfM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/silentflow~linkedin-ads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-silentflow-linkedin-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/silentflow~linkedin-ads-scraper/runs": { "post": { "operationId": "runs-sync-silentflow-linkedin-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/silentflow~linkedin-ads-scraper/run-sync": { "post": { "operationId": "run-sync-silentflow-linkedin-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", "properties": { "keywords": { "title": "Search Keywords", "type": "array", "description": "Keywords to search in the LinkedIn Ads Library (e.g. 'AI', 'software', 'cloud'). Each keyword runs a separate search and paginates through all matching ads.", "items": { "type": "string" } }, "startUrls": { "title": "Ad Library URLs", "type": "array", "description": "Paste any LinkedIn Ad Library URL: a filtered search (https://www.linkedin.com/ad-library/search?keyword=...), an ad detail page, or a company page. Filters in the URL are respected.", "items": { "type": "string" } }, "advertiserUrls": { "title": "Advertiser / Company URLs", "type": "array", "description": "LinkedIn company URLs to get ads from (e.g. https://www.linkedin.com/company/nvidia). Fetches every ad the company is running.", "items": { "type": "string" } }, "adUrls": { "title": "Ad URLs", "type": "array", "description": "Direct LinkedIn ad URLs to scrape. Format: https://www.linkedin.com/ad-library/detail/123456789", "items": { "type": "string" } }, "countries": { "title": "Countries Filter", "type": "array", "description": "Filter ads by target countries (ISO country codes), e.g. ['US', 'GB', 'DE']. Leave empty for all countries.", "default": [], "items": { "type": "string" } }, "dateRange": { "title": "Date Range", "enum": [ "last-30-days", "this-month", "this-year", "last-year", "all-time" ], "type": "string", "description": "Filter ads by date range.", "default": "last-30-days" }, "skipDetails": { "title": "Skip ad pages for searches (faster, cheaper)", "type": "boolean", "description": "When on, searches read the search list only: advertiser, format, headline, body preview, and media. Keywords, Advertiser / Company URLs and pasted Ad Library search URLs do not open each ad's own page, so full body text, per-country impressions, and targeting are not included on those rows, and they are charged at the lower list rate. Ad URLs are the exception: a direct ad link has no search list to read, so its own page is always opened and that row is charged at the detail rate. Much faster and cheaper.", "default": false }, "maxItems": { "title": "Maximum ads", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of ads to return across all keywords, URLs, and advertisers.", "default": 50 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Residential proxies recommended for best results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }