{
"openapi": "3.0.1",
"info": {
"title": "LinkedIn Ad Library Scraper | from $1.00/1K Ads, No Login",
"description": "Scrape the LinkedIn Ad Library without login: ad copy, creatives, payer, run dates, EU impressions and targeting as structured JSON. Search by advertiser, keyword, country or date. Pure HTTP, fast and cheap.",
"version": "0.2",
"x-build-id": "S4YaSWY6SUJinAMcE"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/alexmorain~linkedin-ad-library-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-alexmorain-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/alexmorain~linkedin-ad-library-scraper/runs": {
"post": {
"operationId": "runs-sync-alexmorain-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/alexmorain~linkedin-ad-library-scraper/run-sync": {
"post": {
"operationId": "run-sync-alexmorain-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",
"type": "array",
"description": "Company names or LinkedIn company slugs, one per line: nvidia, doctolib. Each one becomes its own search, and the results carry the advertiser name so you can tell them apart.
How to be sure of a name: open the company LinkedIn page, the slug is the last part of the URL (linkedin.com/company/nvidia). Some groups advertise under a legal entity rather than their brand; if a search comes back empty, that is usually why.
Leave empty if you are searching by keyword across the whole library instead.",
"items": {
"type": "string"
}
},
"keyword": {
"title": "Keyword",
"type": "string",
"description": "A word or phrase to search for in the ads themselves.
Used alone, it sweeps the entire Ad Library and finds every advertiser running that message: the way to discover competitors you had not listed. Used together with advertisers, it narrows each advertiser's ads to those mentioning it.
Leave empty to get all the ads of the advertisers above."
},
"searchUrls": {
"title": "Search URLs",
"type": "array",
"description": "Full Ad Library search URLs, copied straight from your browser: https://www.linkedin.com/ad-library/search?...
The escape hatch: build any filter combination by hand on the LinkedIn site, paste the resulting URL here, and the Actor reproduces it exactly. Useful for filters this input does not expose.
Single ads work too: paste an ad URL such as https://www.linkedin.com/ad-library/detail/1279725554 and the Actor fetches that ad directly. It is billed like any other ad: with details when Include ad details is on, at the listing rate when it is off. To fetch single ads with their details whatever that setting, use Ad URLs below.
One caveat, and it is the reason most competing tools return wrong data: LinkedIn silently ignores a start and end date in a URL unless dateOption=custom-date-range is present too. A URL without it returns the whole corpus while looking filtered. Prefer the date fields below, which always send the complete parameter set.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"adUrls": {
"title": "Ad URLs",
"type": "array",
"description": "Single ads to fetch directly, one per line: an ad URL such as https://www.linkedin.com/ad-library/detail/1279725554, or the numeric ID alone (1279725554).
Each ad comes back with its details (full copy, payer, run dates, and for EU-served ads impressions and targeting), whatever Include ad details says, and is billed at the with-details rate. One request per ad, no search.
The way to refresh a list of ads you already know, or to enrich the IDs a listing run returned. Max ads per query, Ad formats and the date fields do not apply to these ads: you named them one by one.",
"items": {
"type": "string"
}
},
"countries": {
"title": "Countries",
"type": "array",
"description": "Countries where the ads were shown, as ISO 3166-1 alpha-2 codes (US, FR, DE) or English names (United States, France). Names are converted to codes; an entry the Actor does not recognise stops the run with a message naming it, rather than returning nothing.
Leave empty for worldwide, which is the honest default when you do not know where a company advertises. Note that impressions and targeting data only exist for ads served in the EU, so an EU country here is what makes the richest fields appear.",
"items": {
"type": "string"
}
},
"dateOption": {
"title": "Date range",
"enum": [
"all-time",
"last-30-days",
"current-month",
"current-year",
"last-year"
],
"type": "string",
"description": "The period during which the ads ran. The library only holds roughly the last 12 months, whatever you ask for, so \"All time\" means \"the last twelve months\".
Ignored when you fill the two custom date fields below.",
"default": "all-time"
},
"startDate": {
"title": "Custom start date",
"type": "string",
"description": "YYYY-MM-DD, within the last 12 months. It overrides the dropdown above. Filled alone, the range runs from this date to yesterday: LinkedIn returns nothing for a window that ends today.
LinkedIn also returns nothing for a start date more than 12 months back, so an older date is moved forward to exactly 12 months back, with a warning in the log. A start date after the end date or after the last day LinkedIn serves (usually yesterday), or an end date more than 12 months back, stops the run with a clear error before any ad is fetched. With Search URLs or Ad URLs in the same input, the run goes on with those URLs only and says so in the log and the status message.
The custom dates apply to Advertisers, Keyword and Payer searches. Search URLs keep their own parameters and ignore them, and so do Ad URLs.
The Actor always sends the extra parameter LinkedIn requires for a custom range to actually apply, so the filter you set is the filter you get."
},
"endDate": {
"title": "Custom end date",
"type": "string",
"description": "YYYY-MM-DD. Goes with the custom start date. Filled alone, the range starts from the oldest ads the library holds, about 12 months back.
LinkedIn returns nothing for a window that ends today, so an end date of today or later is moved back to yesterday.
An end date more than 12 months back stops the run with a clear error before any ad is fetched: the library holds nothing that old."
},
"payer": {
"title": "Payer name",
"type": "string",
"description": "Filter on the entity that paid for the ad, the \"Paid for by\" line: often a legal entity or an agency rather than the brand.
Useful to map a group whose subsidiaries advertise separately, or to find every brand handled by one agency. Leave empty in normal use."
},
"adFormats": {
"title": "Ad formats",
"type": "array",
"description": "Keep only these formats, one per line, as LinkedIn names them: Single Image Ad, Video Ad, Carousel Ad, Message Ad, Document Ad, Job Ad, Follow Company Ad. LinkedIn also lists Text Ad, Event Ad, Spotlight Ad and Conversation Ad, not yet seen by this Actor. Case does not matter and the final \"Ad\" is optional: video works.
LinkedIn has no format filter of its own, so the Actor reads the results and drops the other formats before they are returned: you are only charged for the ads you get. Max ads per query counts the ads kept, so a cap of 100 still aims at 100 ads of your formats.
To keep a rare format from scanning a whole library, a capped search reads at most 10 times the pages the cap needs, and never fewer than 20 pages (480 ads): 50 pages for a cap of 100. The status message says when a search stopped at that limit. With no cap, every page is read.
Leave empty for every format. Does not apply to Ad URLs.",
"items": {
"type": "string"
}
},
"includeDetails": {
"title": "Include ad details",
"type": "boolean",
"description": "Opens the detail page of every ad, which adds the full ad copy, the payer, the exact run dates and, for ads served in the EU, the impressions (total and per country) and the targeting criteria the advertiser selected.
Off by default because it costs one extra request per ad and is billed at a higher per-ad rate. The efficient pattern: sweep wide with it off to see who advertises and how much, then re-run with it on for the handful of advertisers you actually analyse.
Without it you still get advertiser, format, headline, creatives and a copy preview.",
"default": false
},
"maxAdsPerQuery": {
"title": "Max ads per query",
"minimum": 0,
"type": "integer",
"description": "Stops each search after this many ads returned. The cap applies per search, so three advertisers with a cap of 100 can return up to 300 ads. Ads dropped by Ad formats or skipped by New ads only do not count, and Ad URLs are not capped.
Keep a cap on your first run. A single large advertiser can be running several hundred ads, and you pay per ad returned. 100 is enough to see the shape of a competitor's advertising; raise it once you know what you are getting.
Set 0, or leave the field empty, for no limit at all."
},
"mode": {
"title": "Mode",
"enum": [
"all",
"new-only"
],
"type": "string",
"description": "All ads returns every ad the search finds, on every run. Use it for a one-off export, or to build your first snapshot.
New ads only keeps a persistent registry of every ad previous runs have returned and charged, and returns only ads never seen before. This turns the Actor into monitoring: schedule it daily and a quiet day costs you the start fee alone, since an ad you are not shown is an ad you are not charged for. The first run in this mode still returns everything, because nothing has been seen yet. Once a run has read a search to its very end, later runs stop that search after two pages in a row with no new ad, since LinkedIn lists the newest ads first: a quiet day is quick too. Until then, and again after any run that stopped early (cap, maximum charge, timeout, block), the next run reads the search to the end, so nothing is skipped.
An ad stopped by your maximum charge before being billed is not recorded, so it comes back on the next run.",
"default": "all"
},
"registryKey": {
"title": "Delta registry key",
"type": "string",
"description": "Only used by New ads only mode. Names the persistent registry of already-seen ads.
Leave empty and it is derived from what you search (advertisers, keyword, payer, countries, Search URLs, Ad URLs), which is what you want: the same search always finds its own registry again, and two different searches never pollute each other. Dates, formats, the cap and the details setting are not part of it. Set it by hand only to make several schedules share one memory, for example a daily run and a weekly catch-up over the same advertisers."
},
"webhookUrl": {
"title": "Webhook URL",
"type": "string",
"description": "If set, the Actor POSTs a small JSON summary to this URL at the end of the run, only when at least one ad was returned: actor, runId, mode, newAds, queries. Combined with New ads only and a daily schedule, that is a push notification: silence when nothing moved, a call when a competitor launches ads.
Use the final URL: a redirect is not followed, except a 307 or 308, which gets the same POST once. Leave empty to skip it. An unreachable webhook is logged as a warning and never fails the run. Stored encrypted, like a password, since a webhook URL often carries its own access token."
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Leave as is. Residential proxies are pre-selected because LinkedIn's bot check now blocks most datacenter IPs.
If you run the Actor through the API with the default {\"useApifyProxy\": true}, it starts on datacenter proxies and switches to residential by itself at the first block, for the rest of the run. The per-ad price is the same either way.
If you pick a proxy group or your own proxy URLs here, the Actor keeps exactly what you chose and never switches.",
"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
}
}
}
}
}
}
}
}
}
}