{ "openapi": "3.0.1", "info": { "title": "LinkedIn Ad Library Scraper - Competitor Ads & Targeting", "description": "Scrape LinkedIn Ad Library ads by advertiser, keyword, payer, country and date: ad copy, advertiser, creative (images, video, carousel, document), CTA, landing page, run dates, impressions and targeting where LinkedIn shows them. Daily only-new mode for competitor alerts. No login.", "version": "0.1", "x-build-id": "1Q1dfyQxswZPXQJBA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapewise~linkedin-ad-library-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapewise-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/scrapewise~linkedin-ad-library-scraper/runs": { "post": { "operationId": "runs-sync-scrapewise-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/scrapewise~linkedin-ad-library-scraper/run-sync": { "post": { "operationId": "run-sync-scrapewise-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": { "advertisers": { "title": "Advertisers (company names)", "type": "array", "description": "Company or advertiser names as LinkedIn shows them, one per line, for example Adobe or Canva. Each name is one search and also matches the company's showcase pages (Adobe for Business, Adobe Acrobat...). With keywords too, every advertiser is searched with every keyword.", "items": { "type": "string" } }, "searchQueries": { "title": "Keywords", "type": "array", "description": "Words to find in the ads, one per line, for example webinar or free trial. Alone, each keyword searches every advertiser; with advertisers above, it narrows their ads.", "items": { "type": "string" } }, "payer": { "title": "Paid by", "type": "string", "description": "Optional: only ads paid for by this name (the 'Paid for by' line, often an agency or the legal entity)." }, "countries": { "title": "Countries", "type": "array", "description": "2-letter country codes where the ads were shown, for example US, DE, GB. Several codes = ads shown in any of them. Empty = all countries.", "items": { "type": "string" } }, "dateRange": { "title": "Date range", "enum": [ "any", "last-30-days", "current-month", "current-year", "last-year", "custom" ], "type": "string", "description": "When the ads ran. The Ad Library covers about the last 12 months.", "default": "any" }, "startDate": { "title": "Start date", "type": "string", "description": "Custom range start (YYYY-MM-DD). Setting a start or end date switches the range to Custom." }, "endDate": { "title": "End date", "type": "string", "description": "Custom range end (YYYY-MM-DD). Empty = today." }, "startUrls": { "title": "Ad Library links", "type": "array", "description": "Optional: search links copied from https://www.linkedin.com/ad-library/ after setting filters there, or single ad links like https://www.linkedin.com/ad-library/detail/1595643974.", "items": { "type": "string" } }, "includeDetails": { "title": "Full ad details", "type": "boolean", "description": "On: opens each ad for the full copy, landing page, CTA, video, carousel cards, payer, run dates, impressions and targeting. Off: faster and cheaper summary rows from the search results (advertiser, format, copy preview, headline, creative).", "default": true }, "maxItems": { "title": "Max ads per search", "minimum": 0, "type": "integer", "description": "Cap for each advertiser, keyword or link, newest ads first. 0 = every ad the search has.", "default": 50 }, "onlyNew": { "title": "Only new ads (for schedules)", "type": "boolean", "description": "On: remembers the ads delivered in earlier runs of the same search (in your account) and delivers only ads not seen before. Skipped ads are free.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy by default. Change it only if you know you need to.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }