{ "openapi": "3.0.1", "info": { "title": "LinkedIn Ads Scraper - Low-cost๐Ÿ’ฒ๐Ÿ”ฅ๐Ÿ”๐ŸŒ", "description": "๐Ÿ” Extract LinkedIn sponsored ads by keyword, company, or location. Collect advertiser names, ad headlines, descriptions, image URLs, call-to-actions, and ad page links. Ideal for ad intelligence, competitor monitoring, market research, campaign analysis & social media advertising insights ๐Ÿš€๐Ÿ“Š", "version": "0.0", "x-build-id": "rbFVNaJ5EiNyzeVll" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/delectable_incubator~linkedin-ads-scraper-low-cost/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-delectable_incubator-linkedin-ads-scraper-low-cost", "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/delectable_incubator~linkedin-ads-scraper-low-cost/runs": { "post": { "operationId": "runs-sync-delectable_incubator-linkedin-ads-scraper-low-cost", "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/delectable_incubator~linkedin-ads-scraper-low-cost/run-sync": { "post": { "operationId": "run-sync-delectable_incubator-linkedin-ads-scraper-low-cost", "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", "required": [ "keywords" ], "properties": { "keywords": { "title": "โœ๏ธ๐Ÿ” Keywords for Scraping Ads Metadata (Bulk)", "type": "array", "description": "List of keywords to search for in the LinkedIn Ads Library.\n\nExamples:\nโ€ข ['ai', 'machine learning']\nโ€ข ['nvidia', 'cloud computing']\nโ€ข ['marketing', 'saas']\n\nThe scraper will process each keyword and collect up to maxItemsPerKeyword ads for each.", "default": [ "ai", "cloud" ], "items": { "type": "string" } }, "entreprise": { "title": "๐Ÿข Enter the Company Name for Ads Metadata", "type": "string", "description": "Specify the company whose ads you want to scrape from the LinkedIn Ads Library. Example: 'NVIDIA', 'Google', etc. ๐Ÿข", "default": "nvidia" }, "country": { "title": "๐ŸŒ Select the Country for Scraping Ads", "enum": [ "All ๐ŸŒ", "Albania ๐Ÿ‡ฆ๐Ÿ‡ฑ", "Algeria ๐Ÿ‡ฉ๐Ÿ‡ฟ", "Andorra ๐Ÿ‡ฆ๐Ÿ‡ฉ", "Angola ๐Ÿ‡ฆ๐Ÿ‡ด", "Antigua and Barbuda ๐Ÿ‡ฆ๐Ÿ‡ฌ", "Argentina ๐Ÿ‡ฆ๐Ÿ‡ท", "Armenia ๐Ÿ‡ฆ๐Ÿ‡ฒ", "Australia ๐Ÿ‡ฆ๐Ÿ‡บ", "Austria ๐Ÿ‡ฆ๐Ÿ‡น", "Azerbaijan ๐Ÿ‡ฆ๐Ÿ‡ฟ", "Bahamas ๐Ÿ‡ง๐Ÿ‡ธ", "Bahrain ๐Ÿ‡ง๐Ÿ‡ญ", "Bangladesh ๐Ÿ‡ง๐Ÿ‡ฉ", "Barbados ๐Ÿ‡ง๐Ÿ‡ง", "Belarus ๐Ÿ‡ง๐Ÿ‡พ", "Belgium ๐Ÿ‡ง๐Ÿ‡ช", "Belize ๐Ÿ‡ง๐Ÿ‡ฟ", "Benin ๐Ÿ‡ง๐Ÿ‡ฏ", "Bhutan ๐Ÿ‡ง๐Ÿ‡น", "Bolivia ๐Ÿ‡ง๐Ÿ‡ด", "Bosnia and Herzegovina ๐Ÿ‡ง๐Ÿ‡ฆ", "Botswana ๐Ÿ‡ง๐Ÿ‡ผ", "Brazil ๐Ÿ‡ง๐Ÿ‡ท", "Brunei ๐Ÿ‡ง๐Ÿ‡ณ", "Bulgaria ๐Ÿ‡ง๐Ÿ‡ฌ", "Burkina Faso ๐Ÿ‡ง๐Ÿ‡ซ", "Burundi ๐Ÿ‡ง๐Ÿ‡ฎ", "Cabo Verde ๐Ÿ‡จ๐Ÿ‡ป", "Cambodia ๐Ÿ‡ฐ๐Ÿ‡ญ", "Cameroon ๐Ÿ‡จ๐Ÿ‡ฒ", "Canada ๐Ÿ‡จ๐Ÿ‡ฆ", "Central African Republic ๐Ÿ‡จ๐Ÿ‡ซ", "Chad ๐Ÿ‡น๐Ÿ‡ฉ", "Chile ๐Ÿ‡จ๐Ÿ‡ฑ", "China ๐Ÿ‡จ๐Ÿ‡ณ", "Colombia ๐Ÿ‡จ๐Ÿ‡ด", "Comoros ๐Ÿ‡ฐ๐Ÿ‡ฒ", "Congo ๐Ÿ‡จ๐Ÿ‡ฌ", "Congo (Democratic Republic) ๐Ÿ‡จ๐Ÿ‡ฉ", "Costa Rica ๐Ÿ‡จ๐Ÿ‡ท", "Croatia ๐Ÿ‡ญ๐Ÿ‡ท", "Cuba ๐Ÿ‡จ๐Ÿ‡บ", "Cyprus ๐Ÿ‡จ๐Ÿ‡พ", "Czech Republic ๐Ÿ‡จ๐Ÿ‡ฟ", "Denmark ๐Ÿ‡ฉ๐Ÿ‡ฐ", "Djibouti ๐Ÿ‡ฉ๐Ÿ‡ฏ", "Dominica ๐Ÿ‡ฉ๐Ÿ‡ฒ", "Dominican Republic ๐Ÿ‡ฉ๐Ÿ‡ด", "Ecuador ๐Ÿ‡ช๐Ÿ‡จ", "Egypt ๐Ÿ‡ช๐Ÿ‡ฌ", "El Salvador ๐Ÿ‡ธ๐Ÿ‡ป", "Equatorial Guinea ๐Ÿ‡ฌ๐Ÿ‡ถ", "Eritrea ๐Ÿ‡ช๐Ÿ‡ท", "Estonia ๐Ÿ‡ช๐Ÿ‡ช", "Eswatini ๐Ÿ‡ธ๐Ÿ‡ฟ", "Ethiopia ๐Ÿ‡ช๐Ÿ‡น", "Fiji ๐Ÿ‡ซ๐Ÿ‡ฏ", "Finland ๐Ÿ‡ซ๐Ÿ‡ฎ", "France ๐Ÿ‡ซ๐Ÿ‡ท", "Gabon ๐Ÿ‡ฌ๐Ÿ‡ฆ", "Gambia ๐Ÿ‡ฌ๐Ÿ‡ฒ", "Georgia ๐Ÿ‡ฌ๐Ÿ‡ช", "Germany ๐Ÿ‡ฉ๐Ÿ‡ช", "Ghana ๐Ÿ‡ฌ๐Ÿ‡ญ", "Greece ๐Ÿ‡ฌ๐Ÿ‡ท", "Grenada ๐Ÿ‡ฌ๐Ÿ‡ฉ", "Guatemala ๐Ÿ‡ฌ๐Ÿ‡น", "Guinea ๐Ÿ‡ฌ๐Ÿ‡ณ", "Guinea-Bissau ๐Ÿ‡ฌ๐Ÿ‡ผ", "Guyana ๐Ÿ‡ฌ๐Ÿ‡พ", "Haiti ๐Ÿ‡ญ๐Ÿ‡น", "Honduras ๐Ÿ‡ญ๐Ÿ‡ณ", "Hungary ๐Ÿ‡ญ๐Ÿ‡บ", "Iceland ๐Ÿ‡ฎ๐Ÿ‡ธ", "India ๐Ÿ‡ฎ๐Ÿ‡ณ", "Indonesia ๐Ÿ‡ฎ๐Ÿ‡ฉ", "Iran ๐Ÿ‡ฎ๐Ÿ‡ท", "Iraq ๐Ÿ‡ฎ๐Ÿ‡ถ", "Ireland ๐Ÿ‡ฎ๐Ÿ‡ช", "Italy ๐Ÿ‡ฎ๐Ÿ‡น", "Jamaica ๐Ÿ‡ฏ๐Ÿ‡ฒ", "Japan ๐Ÿ‡ฏ๐Ÿ‡ต", "Jordan ๐Ÿ‡ฏ๐Ÿ‡ด", "Kazakhstan ๐Ÿ‡ฐ๐Ÿ‡ฟ", "Kenya ๐Ÿ‡ฐ๐Ÿ‡ช", "Kiribati ๐Ÿ‡ฐ๐Ÿ‡ฎ", "Korea (North) ๐Ÿ‡ฐ๐Ÿ‡ต", "Korea (South) ๐Ÿ‡ฐ๐Ÿ‡ท", "Kuwait ๐Ÿ‡ฐ๐Ÿ‡ผ", "Kyrgyzstan ๐Ÿ‡ฐ๐Ÿ‡ฌ", "Laos ๐Ÿ‡ฑ๐Ÿ‡ธ", "Latvia ๐Ÿ‡ฑ๐Ÿ‡ป", "Lebanon ๐Ÿ‡ฑ๐Ÿ‡ง", "Lesotho ๐Ÿ‡ฑ๐Ÿ‡ธ", "Liberia ๐Ÿ‡ฑ๐Ÿ‡ธ", "Libya ๐Ÿ‡ฑ๐Ÿ‡พ", "Liechtenstein ๐Ÿ‡ฑ๐Ÿ‡ฎ", "Lithuania ๐Ÿ‡ฑ๐Ÿ‡น", "Luxembourg ๐Ÿ‡ฑ๐Ÿ‡บ", "Madagascar ๐Ÿ‡ฒ๐Ÿ‡ฌ", "Malawi ๐Ÿ‡ฒ๐Ÿ‡ผ", "Malaysia ๐Ÿ‡ฒ๐Ÿ‡พ", "Maldives ๐Ÿ‡ฒ๐Ÿ‡ป", "Mali ๐Ÿ‡ฒ๐Ÿ‡ฑ", "Malta ๐Ÿ‡ฒ๐Ÿ‡น", "Marshall Islands ๐Ÿ‡ฒ๐Ÿ‡ญ", "Mauritania ๐Ÿ‡ฒ๐Ÿ‡ท", "Mauritius ๐Ÿ‡ฒ๐Ÿ‡บ", "Mexico ๐Ÿ‡ฒ๐Ÿ‡ฝ", "Micronesia ๐Ÿ‡ซ๐Ÿ‡ฒ", "Moldova ๐Ÿ‡ฒ๐Ÿ‡ฉ", "Monaco ๐Ÿ‡ฒ๐Ÿ‡จ", "Mongolia ๐Ÿ‡ฒ๐Ÿ‡ณ", "Montenegro ๐Ÿ‡ฒ๐Ÿ‡ช", "Morocco ๐Ÿ‡ฒ๐Ÿ‡ฆ", "Mozambique ๐Ÿ‡ฒ๐Ÿ‡ฟ", "Myanmar ๐Ÿ‡ฒ๐Ÿ‡ฒ", "Namibia ๐Ÿ‡ณ๐Ÿ‡ฆ", "Nauru ๐Ÿ‡ณ๐Ÿ‡ท", "Nepal ๐Ÿ‡ณ๐Ÿ‡ต", "Netherlands ๐Ÿ‡ณ๐Ÿ‡ฑ", "New Zealand ๐Ÿ‡ณ๐Ÿ‡ฟ", "Nicaragua ๐Ÿ‡ณ๐Ÿ‡ฎ", "Niger ๐Ÿ‡ณ๐Ÿ‡ช", "Nigeria ๐Ÿ‡ณ๐Ÿ‡ฌ", "North Macedonia ๐Ÿ‡ฒ๐Ÿ‡ฐ", "Norway ๐Ÿ‡ณ๐Ÿ‡ด", "Oman ๐Ÿ‡ด๐Ÿ‡ฒ", "Pakistan ๐Ÿ‡ต๐Ÿ‡ฐ", "Palau ๐Ÿ‡ต๐Ÿ‡ผ", "Panama ๐Ÿ‡ต๐Ÿ‡ฆ", "Papua New Guinea ๐Ÿ‡ต๐Ÿ‡ฌ", "Paraguay ๐Ÿ‡ต๐Ÿ‡พ", "Peru ๐Ÿ‡ต๐Ÿ‡ช", "Philippines ๐Ÿ‡ต๐Ÿ‡ญ", "Poland ๐Ÿ‡ต๐Ÿ‡ฑ", "Portugal ๐Ÿ‡ต๐Ÿ‡น", "Qatar ๐Ÿ‡ถ๐Ÿ‡ฆ", "Romania ๐Ÿ‡ท๐Ÿ‡ด", "Russia ๐Ÿ‡ท๐Ÿ‡บ", "Rwanda ๐Ÿ‡ท๐Ÿ‡ผ", "Saint Kitts and Nevis ๐Ÿ‡ฐ๐Ÿ‡ณ", "Saint Lucia ๐Ÿ‡ฑ๐Ÿ‡จ", "Saint Vincent and the Grenadines ๐Ÿ‡ป๐Ÿ‡จ", "Samoa ๐Ÿ‡ผ๐Ÿ‡ธ", "San Marino ๐Ÿ‡ธ๐Ÿ‡ฒ", "Sao Tome and Principe ๐Ÿ‡ธ๐Ÿ‡น", "Saudi Arabia ๐Ÿ‡ธ๐Ÿ‡ฆ", "Senegal ๐Ÿ‡ธ๐Ÿ‡ณ", "Serbia ๐Ÿ‡ท๐Ÿ‡ธ", "Seychelles ๐Ÿ‡ธ๐Ÿ‡จ", "Sierra Leone ๐Ÿ‡ธ๐Ÿ‡ฑ", "Singapore ๐Ÿ‡ธ๐Ÿ‡ฌ", "Slovakia ๐Ÿ‡ธ๐Ÿ‡ฐ", "Slovenia ๐Ÿ‡ธ๐Ÿ‡ฎ", "Solomon Islands ๐Ÿ‡ธ๐Ÿ‡ง", "Somalia ๐Ÿ‡ธ๐Ÿ‡ด", "South Africa ๐Ÿ‡ฟ๐Ÿ‡ฆ", "South Sudan ๐Ÿ‡ธ๐Ÿ‡ธ", "Spain ๐Ÿ‡ช๐Ÿ‡ธ", "Sri Lanka ๐Ÿ‡ฑ๐Ÿ‡ฐ", "Sudan ๐Ÿ‡ธ๐Ÿ‡ฉ", "Suriname ๐Ÿ‡ธ๐Ÿ‡ท", "Sweden ๐Ÿ‡ธ๐Ÿ‡ช", "Switzerland ๐Ÿ‡จ๐Ÿ‡ญ", "Syria ๐Ÿ‡ธ๐Ÿ‡พ", "Taiwan ๐Ÿ‡น๐Ÿ‡ผ", "Tajikistan ๐Ÿ‡น๐Ÿ‡ฏ", "Tanzania ๐Ÿ‡น๐Ÿ‡ฟ", "Thailand ๐Ÿ‡น๐Ÿ‡ญ", "Timor-Leste ๐Ÿ‡น๐Ÿ‡ฑ", "Togo ๐Ÿ‡น๐Ÿ‡ฌ", "Tonga ๐Ÿ‡น๐Ÿ‡ด", "Trinidad and Tobago ๐Ÿ‡น๐Ÿ‡น", "Tunisia ๐Ÿ‡น๐Ÿ‡ณ", "Turkey ๐Ÿ‡น๐Ÿ‡ท", "Turkmenistan ๐Ÿ‡น๐Ÿ‡ฒ", "Tuvalu ๐Ÿ‡น๐Ÿ‡ป", "Uganda ๐Ÿ‡บ๐Ÿ‡ฌ", "Ukraine ๐Ÿ‡บ๐Ÿ‡ฆ", "United Arab Emirates ๐Ÿ‡ฆ๐Ÿ‡ช", "United Kingdom ๐Ÿ‡ฌ๐Ÿ‡ง", "United States ๐Ÿ‡บ๐Ÿ‡ธ", "Uruguay ๐Ÿ‡บ๐Ÿ‡พ", "Uzbekistan ๐Ÿ‡บ๐Ÿ‡ฟ", "Vanuatu ๐Ÿ‡ป๐Ÿ‡บ", "Vatican City ๐Ÿ‡ป๐Ÿ‡ฆ", "Venezuela ๐Ÿ‡ป๐Ÿ‡ช", "Vietnam ๐Ÿ‡ป๐Ÿ‡ณ", "Yemen ๐Ÿ‡พ๐Ÿ‡ช", "Zambia ๐Ÿ‡ฟ๐Ÿ‡ฒ", "Zimbabwe ๐Ÿ‡ฟ๐Ÿ‡ผ" ], "type": "string", "description": "Choose the country you want to scrape LinkedIn ads from. You can pick 'All ๐ŸŒ' or any specific country! ๐ŸŒŽ", "default": "All ๐ŸŒ" }, "date": { "title": "๐Ÿ“… Choose Date Sort (When Ads Were Posted) โฐโณ", "enum": [ "Any", "Last 30 days", "This month", "This year", "Last year" ], "type": "string", "description": "Choose how you want to sort ads by date! โฐโณ You can select 'Any' for all dates, or narrow it down by 'Last 30 days', 'This month', or 'This year'.", "default": "Any" }, "maxItemsPerKeyword": { "title": "๐ŸŽฏ Maximum Ads Per Keyword", "type": "integer", "description": "Maximum number of ads to collect for EACH keyword.\n\nThe scraper will:\nโ€ข Scroll through results for each keyword\nโ€ข Stop when reaching this limit OR after 10 consecutive empty scrolls\nโ€ข Move to the next keyword automatically", "default": 60 } } }, "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 } } } } } } } } } }