{ "openapi": "3.0.1", "info": { "title": "LinkedIn Ad Library Scraper & Competitor Ad Monitor", "description": "Scrape LinkedIn's Ad Library by company or keyword: ad copy, headline, CTA, landing page, images and videos, run dates, impressions by country and targeting. Monitor mode returns only new ads, with webhook alerts. Pay per ad.", "version": "0.1", "x-build-id": "9nMa2K05oLSjmLEyw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yushi3~linkedin-ad-library-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yushi3-linkedin-ad-library-monitor", "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/yushi3~linkedin-ad-library-monitor/runs": { "post": { "operationId": "runs-sync-yushi3-linkedin-ad-library-monitor", "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/yushi3~linkedin-ad-library-monitor/run-sync": { "post": { "operationId": "run-sync-yushi3-linkedin-ad-library-monitor", "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", "type": "array", "description": "Company names as you'd type them in the Ad Library (hubspot, Salesforce), or Ad Library search URLs (https://www.linkedin.com/ad-library/search?accountOwner=hubspot), which keep all their filters.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Words or phrases to find in ad copy, across all advertisers (e.g. CRM, \"AI agents\"), or Ad Library search URLs.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Optional. Two-letter country codes (US, DE, GB…). Only ads shown in these countries are returned. Applies to every advertiser and keyword unless its search URL already sets countries.", "items": { "type": "string" } }, "dateOption": { "title": "Shown during", "enum": [ "all", "last-30-days", "current-month", "current-year", "last-year" ], "type": "string", "description": "Only ads shown during this period.", "default": "all" }, "maxAdsPerSearch": { "title": "Max ads per advertiser or keyword", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many ads for each advertiser or keyword (24 per results page).", "default": 50 }, "scrapeDetails": { "title": "Open each ad's page", "type": "boolean", "description": "Read each ad's own page for the full copy, CTA, landing page, video file, payer and, for ads shown in the EU, run dates, impressions by country and targeting. Turn off for a faster, cheaper list of ads from search results only.", "default": true }, "onlyNewAds": { "title": "Only new ads", "type": "boolean", "description": "Return (and charge for) only ads not seen in earlier runs for the same advertiser or keyword. The first run returns everything and becomes the baseline. Turn on for scheduled monitoring.", "default": false }, "alertWebhookUrl": { "title": "Alert webhook URL", "type": "string", "description": "Optional. Receives a POST for each ad that appeared since the previous run (Slack, Zapier, Make, n8n)." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. By default LinkedIn is fetched directly and falls back to Apify datacenter, then residential proxies, with fresh IPs, only when LinkedIn blocks a request. Set a proxy here to use it for every request 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 }, "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 } } } } } } } } } }