{ "openapi": "3.0.1", "info": { "title": "LinkedIn Ad Library Scraper - Ads, Impressions & Targeting", "description": "Scrape the LinkedIn Ad Library by company, keyword or payer. Every ad a brand runs on LinkedIn, with impression ranges by country, the targeting the advertiser selected, and the agency that paid for it. No login and no API key.", "version": "0.0", "x-build-id": "o6fQoQGOlsmc74xdF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eiv~linkedin-ad-library-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eiv-linkedin-ad-library-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/eiv~linkedin-ad-library-scraper/runs": { "post": { "operationId": "runs-sync-eiv-linkedin-ad-library-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/eiv~linkedin-ad-library-scraper/run-sync": { "post": { "operationId": "run-sync-eiv-linkedin-ad-library-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": { "companies": { "title": "Companies", "maxItems": 100, "type": "array", "description": "LinkedIn company page URLs, numeric company IDs, or company names. A numeric ID is the precise match; a name uses LinkedIn's own fuzzy search.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "maxItems": 100, "type": "array", "description": "Free-text search across ad copy, for finding who advertises on a theme rather than a named brand.", "items": { "type": "string" }, "default": [] }, "payers": { "title": "Payers", "maxItems": 100, "type": "array", "description": "Search by who PAID for the ad rather than whose brand it carries - usually a media agency.", "items": { "type": "string" }, "default": [] }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes to restrict to. Leave empty for all.", "items": { "type": "string" }, "default": [] }, "startDate": { "title": "Start date", "type": "string", "description": "YYYY-MM-DD. LinkedIn only keeps about one year of ads, so earlier dates return nothing." }, "endDate": { "title": "End date", "type": "string", "description": "YYYY-MM-DD. Defaults to today." }, "includeDetails": { "title": "Include impressions and targeting", "type": "boolean", "description": "Fetch each ad's detail page for impression ranges by country, targeting parameters and the paying entity. One extra request per ad, charged separately.", "default": false }, "maxAdsPerTarget": { "title": "Max ads per target", "minimum": 1, "maximum": 20000, "type": "integer", "description": "LinkedIn serves 24 ads per query, so this Actor narrows the date range repeatedly to reach more. Raise it freely - the default is kept modest so a first run finishes quickly, not because the Actor is limited to it.", "default": 50 }, "maxTotalAds": { "title": "Max ads in total", "minimum": 1, "maximum": 200000, "type": "integer", "description": "A ceiling across every target in the run.", "default": 2000 }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 60000, "type": "integer", "description": "LinkedIn rate-limits by address. Raise this if runs report a high refusal rate even on residential addresses.", "default": 1500 }, "proxyConfig": { "title": "Proxy", "type": "object", "description": "Use the RESIDENTIAL group. LinkedIn refuses requests by address, and it refuses datacenter addresses heavily and unpredictably: measured on 2026-09-22 at 25%, then 6%, then 100% within half an hour, the last of which collected nothing at all. This Actor retries on a fresh address automatically and reports the refusal rate at the end of every run, but no amount of retrying helps when the whole datacenter pool is being refused. If HTTP 407 appears in the log, the RESIDENTIAL group is not included in your Apify plan - switch the group back.", "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 } } } } } } } } } }