{ "openapi": "3.0.1", "info": { "title": "LinkedIn Ad Library: B2B Competitor Ad Spy", "description": "Scrape LinkedIn's public Ad Library: every B2B ad an advertiser runs. Search by company or keyword. Get creatives, copy, formats, dates, impressions per country and the advertiser targeting breakdown (job title, seniority, company size, industry). For competitor spy, sales intel, agencies.", "version": "1.0", "x-build-id": "QfogBzxXZvN7vCoVk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dltik~linkedin-ad-library/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dltik-linkedin-ad-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/dltik~linkedin-ad-library/runs": { "post": { "operationId": "runs-sync-dltik-linkedin-ad-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/dltik~linkedin-ad-library/run-sync": { "post": { "operationId": "run-sync-dltik-linkedin-ad-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", "properties": { "accountOwner": { "title": "Advertiser company", "type": "string", "description": "Company / advertiser name to search (e.g. 'Salesforce', 'Nike'). Combine with keyword for finer search." }, "keyword": { "title": "Keyword", "type": "string", "description": "Search ads containing this keyword in their copy." }, "countries": { "title": "Countries", "type": "array", "description": "ISO 2-letter country codes to filter ads by where they were shown (e.g. ['US','GB','FR']). Empty = all countries.", "items": { "type": "string" } }, "dateOption": { "title": "Date range", "enum": [ "last-month", "last-3-months", "last-6-months", "last-year", "all-time" ], "type": "string", "description": "How far back to search.", "default": "last-year" }, "maxResults": { "title": "Max ads per query", "minimum": 1, "maximum": 24, "type": "integer", "description": "Cap on ads returned per query. LinkedIn's public Ad Library serves ~24 ads per search; the in-page 'load more' is an XHR that isn't exposed here. Broaden coverage by running multiple queries (different keywords, countries, date ranges) rather than chasing a deeper cap.", "default": 24 }, "enrichDetails": { "title": "Enrich with DSA details (impressions, targeting)", "type": "boolean", "description": "For each ad, fetch the detail page to extract DSA premium fields: impressions per country, total impressions, targeting filters. Slower (~1s/ad) but unlocks the most valuable data.", "default": false }, "useResidentialProxy": { "title": "Use residential proxy (optional)", "type": "boolean", "description": "Enable only if you hit rate limits on large runs — datacenter IPs work fine for the public Ad Library.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Advanced: override the proxy. Only honored when 'Use residential proxy' is enabled.", "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 } } }, "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 } } } } } } } } } }