{ "openapi": "3.0.1", "info": { "title": "LinkedIn Ad Library Scraper — Competitor LinkedIn Ads Library", "description": "Scrape every ad a company runs in the LinkedIn Ads Library, with the full detail page: copy, landing URL with UTMs, payer, run dates, impressions by country and targeting. Pin a competitor by company URL, or search by keyword or country. Monitoring, company facts, AI tags. No login.", "version": "0.1", "x-build-id": "9zFIuzax2tOGkrIiY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hyperbach~linkedin-ad-library-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hyperbach-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/hyperbach~linkedin-ad-library-scraper/runs": { "post": { "operationId": "runs-sync-hyperbach-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/hyperbach~linkedin-ad-library-scraper/run-sync": { "post": { "operationId": "run-sync-hyperbach-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 (advertisers)", "type": "array", "description": "Each entry is one advertiser: a LinkedIn company URL (`linkedin.com/company/hubspot`), a company id (`68529`), a slug (`hubspot`) or a name. An id, URL or slug pins the exact company — only ads that company runs, not the agencies that mention it. A name with spaces is matched as LinkedIn's advertiser-name search and kept to advertisers of exactly that name (switch on `includeRelatedAdvertisers` to keep the agencies too).", "default": [], "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Words in the ad. One search per line, across every advertiser.", "default": [], "items": { "type": "string" } }, "payers": { "title": "Payers (\"Paid for by\")", "type": "array", "description": "The entity LinkedIn shows as \"Paid for by\" — often the legal name, e.g. `HubSpot, Inc.`.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "LinkedIn URLs: an Ad Library search you set up on linkedin.com/ad-library (every filter in it is kept), an ad's detail page, an Employer Brand page, or a company page. A text file, CSV or published Google Sheet with one URL per line works too (Link remote text file).", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "adIds": { "title": "Ad ids", "type": "array", "description": "Single ads by id or detail URL (`linkedin.com/ad-library/detail/1558773703`): re-read an ad you already know, e.g. to watch its impressions move.", "items": { "type": "string", "pattern": "^\\s*(\\d{5,20}|\\S*linkedin\\.com/ad-library/detail/\\d{5,20}\\S*)\\s*$" }, "default": [] }, "searches": { "title": "Searches with their own filters", "type": "array", "description": "Several searches in one run, each with its own filters and cap. Each entry names one of `company`, `keyword`, `payer` or `url`, plus any of `countries`, `dateRange`, `startDate`, `endDate`, `impressionsMin`, `impressionsMax`, `targetingIncludes`, `targetingExcludes`, `sortOrder`, `includeRelatedAdvertisers`, `maxAds`. An entry with only `countries` is every ad shown there. Example: `[{\"company\": \"hubspot\", \"countries\": [\"DE\", \"FR\"]}, {\"keyword\": \"webinar\", \"dateRange\": \"last-30-days\", \"maxAds\": 200}]`.", "default": [] }, "resultType": { "title": "Return", "enum": [ "ads", "counts" ], "type": "string", "description": "`counts` returns one row per search with LinkedIn's own total, from one page load and no ads scraped. A search that finds nothing is free: use it to check which of a list of companies advertise at all.", "default": "ads" }, "countries": { "title": "Countries", "type": "array", "description": "Ads shown in these countries. Empty = everywhere. Several are combined (shown in any of them). LinkedIn ignores this filter when a targeting or impressions filter is set.", "items": { "type": "string", "enum": [ "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "CB", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CK", "CR", "CI", "HR", "CU", "CY", "CZ", "CD", "DK", "DJ", "DM", "DO", "TP", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KR", "KP", "KO", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "AN", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "GS", "SH", "KN", "LC", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "CS", "SC", "SL", "SG", "SK", "SI", "SB", "SO", "ZA", "SS", "ES", "LK", "SD", "OM", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UY", "UZ", "VU", "VA", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "YU", "ZM", "ZW" ], "enumTitles": [ "Afghanistan", "Aland Islands", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Caribbean Nations", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo", "Cook Islands", "Costa Rica", "Cote D’Ivoire (Ivory Coast)", "Croatia", "Cuba", "Cyprus", "Czech Republic", "Democratic Republic of the Congo", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Falkland Islands (Malvinas)", "Faroe Islands", "Federated States of Micronesia", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard Island and McDonald Islands", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Korea", "Korea (North)", "Kosovo", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Macedonia", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "Northern Mariana Islands", "Norway", "Pakistan", "Palau", "Palestinian Territory", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn", "Poland", "Portugal", "Puerto Rico", "Qatar", "Reunion", "Romania", "Russian Federation", "Rwanda", "S. Georgia and S. Sandwich Islands", "Saint Helena", "Saint Kitts and Nevis", "Saint Lucia", "Saint Pierre and Miquelon", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Serbia and Montenegro", "Seychelles", "Sierra Leone", "Singapore", "Slovak Republic", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Sultanate of Oman", "Suriname", "Svalbard and Jan Mayen", "Swaziland", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Uzbekistan", "Vanuatu", "Vatican City State (Holy See)", "Venezuela", "Vietnam", "Virgin Islands (British)", "Virgin Islands (U.S.)", "Wallis and Futuna", "Western Sahara", "Yemen", "Yugoslavia", "Zambia", "Zimbabwe" ] }, "default": [] }, "dateRange": { "title": "Date range", "enum": [ "any", "last-30-days", "current-month", "current-year", "last-year", "custom" ], "type": "string", "description": "When the ad ran, as LinkedIn's own date filter. For your own dates set `startDate` / `endDate`.", "default": "any" }, "startDate": { "title": "Ran on or after", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "YYYY-MM-DD. With an end date or alone." }, "endDate": { "title": "Ran on or before", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "YYYY-MM-DD." }, "impressionsMin": { "title": "Impressions at least", "minimum": 0, "type": "integer", "description": "LinkedIn's impressions filter. It applies to ads shown in the EU (the only ads LinkedIn publishes impressions for), and LinkedIn then ignores the country filter (measured 2026-09-28)." }, "impressionsMax": { "title": "Impressions at most", "minimum": 0, "type": "integer", "description": "Upper bound for the impressions filter; EU ads only." }, "targetingIncludes": { "title": "Targeting uses", "type": "array", "description": "Only ads whose advertiser targeted by these categories (EU ads). LinkedIn ignores the country filter when this is set.", "items": { "type": "string", "enum": [ "LANGUAGE", "LOCATION", "AUDIENCE", "DEMOGRAPHIC", "COMPANY", "EDUCATION", "JOB", "INTERESTS_AND_TRAITS" ], "enumTitles": [ "Language", "Location", "Audience", "Demographic", "Company", "Education", "Job", "Member interests and traits" ] }, "default": [] }, "targetingExcludes": { "title": "Targeting excludes by", "type": "array", "description": "Only ads whose advertiser excluded audiences by these categories (EU ads).", "items": { "type": "string", "enum": [ "LANGUAGE", "LOCATION", "AUDIENCE", "DEMOGRAPHIC", "COMPANY", "EDUCATION", "JOB", "INTERESTS_AND_TRAITS" ], "enumTitles": [ "Language", "Location", "Audience", "Demographic", "Company", "Education", "Job", "Member interests and traits" ] }, "default": [] }, "sortOrder": { "title": "Order", "enum": [ "newest", "oldest" ], "type": "string", "description": "The order LinkedIn lists the ads in.", "default": "newest" }, "includeRelatedAdvertisers": { "title": "Include related advertisers", "type": "boolean", "description": "For companies: also return ads by other advertisers whose name contains the company's (partner agencies, resellers, subsidiaries) — LinkedIn's own advertiser-name search. Off, only the company itself.", "default": false }, "adFormats": { "title": "Ad formats", "type": "array", "description": "Keep only these formats. Filtered on the list before any detail page is opened, so a skipped ad costs nothing. Conversation ads are labelled Message Ad by LinkedIn and come as `message`.", "items": { "type": "string", "enum": [ "image", "video", "carousel", "document", "article", "event", "message", "text", "spotlight", "follower", "job", "employer_brand" ], "enumTitles": [ "Image (single image)", "Video", "Carousel", "Document", "Article", "Event", "Message (Sponsored InMail)", "Text", "Spotlight", "Follower", "Job", "Employer Brand (company discovery)" ] }, "default": [] }, "minDaysRunning": { "title": "Ran at least (days)", "minimum": 0, "type": "integer", "description": "Only ads that ran this many days or more — the long runners, the ones worth copying. Needs run dates, which LinkedIn publishes for ads shown in the EU.", "default": 0 }, "onlyActive": { "title": "Only ads still running", "type": "boolean", "description": "Only ads whose last day is today or yesterday (EU ads carry dates).", "default": false }, "includeDetails": { "title": "Open every ad's detail page", "type": "boolean", "description": "On: the full copy, destination URL with UTMs, payer, run dates, impressions by country and the targeting. Off: the list view only (the first lines of the copy, headline, format, image) — cheaper and faster.", "default": true }, "includeCompanyInfo": { "title": "Add the advertiser's company facts", "type": "boolean", "description": "Industry, company size, headquarters, founded, type, website, followers and specialties from the company's public LinkedIn page — on every ad row, plus one `advertiser` row per company.", "default": false }, "tagAds": { "title": "Tag each ad (angle, offer, funnel stage, audience function)", "type": "boolean", "description": "Typed tags per ad from a classification model: angle, CTA intent, tone, offer type, funnel stage, target job function and sentiment, each with a confidence.", "default": false }, "analyzeAds": { "title": "Analyse each ad in words (hook, offer, audience, strategy)", "type": "boolean", "description": "A language model reads the ad and writes its hook, the concrete offer, who it is written for and the advertiser's apparent strategy. Model usage included.", "default": false }, "ocrImageAds": { "title": "Read the text in image ads", "type": "boolean", "description": "The words baked into the artwork, read by a vision model (`ad_ocr_text`). Model usage included.", "default": false }, "transcribeVideos": { "title": "Transcribe video ads", "type": "boolean", "description": "What the video says, as text, with its language and first three seconds. A silent video is checked and not billed.", "default": false }, "openaiApiKey": { "title": "OpenAI API key (optional)", "type": "string", "description": "Your own key for `analyzeAds`, `ocrImageAds` and `transcribeVideos`, if you want the model usage on your account. Not needed: the Actor has its own." }, "summaryRows": { "title": "Add summary rows", "type": "boolean", "description": "Free rows after the ads: one `advertiser_profile` per advertiser (ads, still running, longest run, formats, countries, landing domains) and one `landing_page` per destination URL.", "default": false }, "outputFormat": { "title": "Row shape", "enum": [ "full", "compact" ], "type": "string", "description": "`compact` keeps the columns most people use and drops the nested ones.", "default": "full" }, "maxAds": { "title": "Max ads", "minimum": 0, "type": "integer", "description": "Ads delivered in the whole run, exactly (0 = no limit). Never exceeded, and you are never billed for more.", "default": 0 }, "maxAdsPerSearch": { "title": "Max ads per search", "minimum": 0, "type": "integer", "description": "Ads per company, keyword, payer or URL (0 = no limit).", "default": 0 }, "onlyNewAds": { "title": "Only ads not delivered before", "type": "boolean", "description": "Skip every ad an earlier run with the same searches already delivered — not returned, not charged. Schedule the run and each one brings only what is new.", "default": false }, "includeEndedAds": { "title": "Report ads that stopped running", "type": "boolean", "description": "Add an `ended` row for every ad an earlier run saw that a complete scan of the same search no longer lists. Free.", "default": false }, "stateStoreName": { "title": "Monitoring memory name", "type": "string", "description": "Name for the memory `onlyNewAds` and `includeEndedAds` use. Empty: named after your searches, so the same input on a schedule finds its own memory." }, "runTag": { "title": "Run tag", "type": "string", "description": "Your label, copied onto every row (`run_tag`), to tell runs apart in one sheet." }, "resumeFromRunId": { "title": "Continue an earlier run", "type": "string", "description": "The id of a run that stopped early (timeout, abort) with the same input: this run carries on from where it stopped, with no ad delivered or billed twice." } } }, "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 } } } } } } } } } }