{ "openapi": "3.0.1", "info": { "title": "LinkedIn Ads Scraper", "description": "🔍 Extract comprehensive LinkedIn ads data from the Ad Library. Get ad creatives, headlines, copy, advertiser info, and targeting details. Perfect for competitive intelligence, 📈 market research, and ad campaign analysis. Supports keyword search, date filtering, and multi-country targeting.", "version": "0.0", "x-build-id": "9e95SSPmK5GYvCL15" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dz_omar~linkedin-ads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dz_omar-linkedin-ads-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/dz_omar~linkedin-ads-scraper/runs": { "post": { "operationId": "runs-sync-dz_omar-linkedin-ads-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/dz_omar~linkedin-ads-scraper/run-sync": { "post": { "operationId": "run-sync-dz_omar-linkedin-ads-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": { "maxResults": { "title": "📊 Maximum Results", "minimum": 0, "type": "integer", "description": "Maximum number of ads to scrape per URL / per search. Set to 0 for unlimited. Worst-case total = (number of URLs + number of searches) × this value. Example: 2 URLs + 3 searches × 11 = 55 ads max.", "default": 1 }, "fetchAdDetail": { "title": "🔍 Fetch Ad Detail", "type": "boolean", "description": "When enabled, the scraper visits each ad's detail page to collect richer data: exact run dates, payer entity, total impressions range, impressions by country (with %), targeting parameters (inclusions/exclusions per category), video URLs, full ad text, and destination URL. This makes the scraper slower since it fires one extra request per ad.", "default": false }, "urls": { "title": "LinkedIn Ad Library URLs", "type": "array", "description": "One or more LinkedIn Ad Library search URLs. Copy the URL directly from your browser after applying all filters on linkedin.com/ad-library.", "items": { "type": "object", "properties": { "url": { "title": "LinkedIn Ad Library URL", "description": "A linkedin.com/ad-library URL (search or detail). Example: https://www.linkedin.com/ad-library/search?keyword=apify&countries=US", "type": "string", "pattern": "^https://www\\.linkedin\\.com/ad-library/.+" } }, "required": [ "url" ] }, "default": [ { "url": "https://www.linkedin.com/ad-library/search?accountOwner=nivide&payer=nivide&keyword=nivide" } ] }, "searches": { "title": "Searches", "type": "array", "description": "One or more independent search configurations. Each entry produces its own search job.", "items": { "type": "object", "properties": { "accountOwner": { "title": "🏢 Company or Advertiser", "type": "string", "description": "Filter by company or advertiser name (e.g., 'Apify', 'Microsoft'). Matches the 'Company or advertiser' field on LinkedIn Ad Library. ⚠️ At least one of Company, Payer, or Keyword is required per search.", "editor": "textfield" }, "payer": { "title": "💳 Payer", "type": "string", "description": "Filter by payer name the entity that paid for the ad. May differ from the advertiser. Matches the 'Payer' field on LinkedIn Ad Library. ⚠️ At least one of Company, Payer, or Keyword is required per search.", "editor": "textfield" }, "keyword": { "title": "🔍 Keyword", "type": "string", "description": "Word or phrase to search for (e.g., 'apify', 'marketing', 'saas'). Matches the 'Keyword' field on LinkedIn Ad Library. ⚠️ At least one of Company, Payer, or Keyword is required per search.", "editor": "textfield" }, "countries": { "title": "🌍 Countries", "description": "One or more countries to filter ads by. Leave empty for all countries.", "type": "array", "editor": "select", "items": { "type": "string", "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" ], "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" ] } }, "sortOrder": { "title": "🔃 Sort Order", "type": "string", "description": "Sort ads by date. 'Newest to oldest' is the default on LinkedIn.", "editor": "select", "enum": [ "DESCENDING", "ASCENDING" ], "enumTitles": [ "📅 Newest to oldest", "📅 Oldest to newest" ], "default": "DESCENDING" }, "dateOption": { "title": "📅 Date Filter", "type": "string", "description": "Predefined date range. Overridden if both Start Date and End Date are specified below.", "editor": "select", "enum": [ "last-30-days", "current-month", "current-year", "last-year", "custom-date-range" ], "enumTitles": [ "📅 Last 30 Days", "📅 This Month", "📋 This Year", "📋 Last Year", "🗓️ Custom Date Range" ] }, "startDate": { "title": "🚀 Start Date (Custom Range)", "type": "string", "description": "Start date in YYYY-MM-DD format. When combined with End Date, takes priority over the Date Filter.", "editor": "datepicker" }, "endDate": { "title": "🏁 End Date (Custom Range)", "type": "string", "description": "End date in YYYY-MM-DD format. When combined with Start Date, takes priority over the Date Filter.", "editor": "datepicker" }, "impressionsMinValue": { "title": "Impressions Min Value", "type": "integer", "description": "Minimum number of impressions. Use together with 'Impressions Min Unit'.", "minimum": 0 }, "impressionsMinUnit": { "title": "Impressions Min Unit", "type": "string", "description": "Unit for the minimum impressions value. Use 'None' for exact number.", "editor": "select", "enum": [ "none", "thousand", "million" ], "enumTitles": [ "None (exact number)", "Thousand", "Million" ] }, "impressionsMaxValue": { "title": "Impressions Max Value", "type": "integer", "description": "Maximum number of impressions. Use together with 'Impressions Max Unit'. Leave empty for no upper limit.", "minimum": 0 }, "impressionsMaxUnit": { "title": "Impressions Max Unit", "type": "string", "description": "Unit for the maximum impressions value. Use 'None' for exact number.", "editor": "select", "enum": [ "none", "thousand", "million" ], "enumTitles": [ "None", "Thousand", "Million" ] }, "includedTargetingFacetCategories": { "title": "🎯 Included Targeting Categories", "type": "array", "description": "Only return ads that include these targeting categories.", "editor": "select", "items": { "type": "string", "enumTitles": [ "Language", "Location", "Audience", "Demographic", "Company", "Education", "Job", "Interests and Traits" ], "enum": [ "LANGUAGE", "LOCATION", "AUDIENCE", "DEMOGRAPHIC", "COMPANY", "EDUCATION", "JOB", "INTERESTS_AND_TRAITS" ] } }, "excludedTargetingFacetCategories": { "title": "🚫 Excluded Targeting Categories", "type": "array", "description": "Only return ads that exclude these targeting categories.", "editor": "select", "items": { "type": "string", "enumTitles": [ "Language", "Location", "Audience", "Demographic", "Company", "Education", "Job", "Interests and Traits" ], "enum": [ "LANGUAGE", "LOCATION", "AUDIENCE", "DEMOGRAPHIC", "COMPANY", "EDUCATION", "JOB", "INTERESTS_AND_TRAITS" ] } } }, "required": [], "additionalProperties": false } } } }, "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 } } } } } } } } } }