{ "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": "GcfAjvsBnjpYnHBY6" }, "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 detail pages (faster, cheaper)", "type": "boolean", "description": "When on, keyword searches and company pages return only what the search list shows: advertiser, format, headline, body preview and media. Their ad pages stay closed, so full body text, run dates, impressions and targeting are not included, and every one of those rows says so in its detailsStatus column. Ad links you paste in Ad URLs always open their own page, so those rows keep the full data. 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" ] } }, "limit": { "title": "Limit (deprecated)", "minimum": 1, "type": "integer", "description": "Deprecated alias of Max items, kept for existing tasks. Use Max items instead." } } }, "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 } } } } } } } } } }