{ "openapi": "3.0.1", "info": { "title": "LinkedIn Top Content & Top Voices Scraper", "description": "Scrapes LinkedIn's public Top Content directory to extract curated high-engagement posts and Top Voice influencers across 40+ categories. Get post text, author profiles, follower counts, reaction metrics, and Top Voice badges. No login, no cookies, no account ban risk. $2 per 1,000 posts.", "version": "0.0", "x-build-id": "8p3O6WRQIpnBs7xVP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~linkedin-top-content-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-linkedin-top-content-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/logiover~linkedin-top-content-scraper/runs": { "post": { "operationId": "runs-sync-logiover-linkedin-top-content-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/logiover~linkedin-top-content-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-linkedin-top-content-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": { "mode": { "title": "Scraping Mode", "enum": [ "directory", "category", "url-list" ], "type": "string", "description": "How the scraper traverses LinkedIn's Top Content directory. 'directory' = crawl all 40+ categories (largest run, ~30K posts). 'category' = crawl one category and its subtopics (~500-1000 posts). 'url-list' = scrape only the specific top-content URLs you provide (most precise).", "default": "category" }, "category": { "title": "Category Slug", "type": "string", "description": "For mode='category'. The category slug from LinkedIn's directory. Common values: marketing, artificial-intelligence, career, leadership, sales, finance, technology, hr, productivity, communication, customer-experience, training-development, innovation, project-management, business-strategy. Browse the full list at https://www.linkedin.com/top-content/.", "default": "marketing" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "For mode='url-list'. Paste specific LinkedIn Top Content URLs to scrape. Each URL will be scraped without sub-page traversal. Example: https://www.linkedin.com/top-content/marketing/social-media-engagement-tactics/", "default": [], "items": { "type": "string" } }, "maxPosts": { "title": "Max Posts", "minimum": 0, "type": "integer", "description": "Maximum number of posts to save to the dataset. The scraper deduplicates by post ID across pages, so the same post appearing on multiple topic pages is only counted once. Set to 0 for unlimited.", "default": 500 }, "maxDepth": { "title": "Max Crawl Depth", "minimum": 2, "maximum": 4, "type": "integer", "description": "How deep to traverse the directory tree. 2 = categories only (40 pages, ~360 posts). 3 = + subcategories (~3K posts). 4 = + leaf topics (full crawl, ~30K posts). Only applies to 'directory' and 'category' modes.", "default": 4 }, "onlyTopVoices": { "title": "Top Voices Only", "type": "boolean", "description": "When enabled, only returns posts whose authors carry LinkedIn's official 'Top Voice' / 'Thought Leader' badge. Use this for premium influencer discovery or B2B outreach prospect lists where credibility signal matters.", "default": false }, "minReactions": { "title": "Min Reactions", "minimum": 0, "type": "integer", "description": "Filter out posts with fewer than this many reactions. Useful for surfacing only the highest-engagement content. Set to 0 to keep all posts (LinkedIn's directory already curates for engagement, so even '0' returns quality posts).", "default": 0 }, "locale": { "title": "Page Language", "enum": [ "en", "tr", "es", "fr", "de", "pt", "it", "nl", "pl" ], "type": "string", "description": "Locale for page rendering. LinkedIn returns category names and metadata in the requested language. Post content is always in the original language the author wrote.", "default": "en" } } }, "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 } } } } } } } } } }