{ "openapi": "3.0.1", "info": { "title": "Post Engagement Scraper for LinkedIn - Commenters", "description": "Turn the people who commented on LinkedIn posts into a lead list. One row per person, enriched from their own public profile with job title, company, seniority and location, and deduplicated across posts. No login.", "version": "0.1", "x-build-id": "XvvIKfjGHCw5R0TBF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~linkedin-post-engagement-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-linkedin-post-engagement-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/scrapesage~linkedin-post-engagement-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-linkedin-post-engagement-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/scrapesage~linkedin-post-engagement-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-linkedin-post-engagement-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": { "postUrls": { "title": "Post URLs", "type": "array", "description": "LinkedIn post permalinks (https://www.linkedin.com/posts/...-activity-...). The most precise input when you already know the posts you care about.", "items": { "type": "string" } }, "companyUrls": { "title": "Company URLs", "type": "array", "description": "Company pages whose recent posts should be read for engagement, e.g. https://www.linkedin.com/company/supabase or just the slug.", "items": { "type": "string" } }, "profileUrls": { "title": "Profile URLs", "type": "array", "description": "People whose recent posts should be read for engagement, e.g. a founder whose audience you want to reach.", "items": { "type": "string" } }, "enrichProfiles": { "title": "Enrich each commenter (recommended)", "type": "boolean", "description": "Open every commenter's public profile to add job title, seniority, department, current company, location and follower count. Turning it off is much faster and cheaper but returns only the name, profile link and comment.", "default": true }, "dedupePeople": { "title": "One row per person", "type": "boolean", "description": "Merge someone who commented on several of the posts into a single row with timesEngaged and the list of posts. Turn off to get one row per comment instead.", "default": true }, "includeCompanyPages": { "title": "Include company-page commenters", "type": "boolean", "description": "Some comments come from brand accounts rather than people. Off by default so a lead list contains people; each row carries isCompanyPage either way.", "default": false }, "maxPostsPerSource": { "title": "Max posts per profile/company", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many recent posts to read for each profile or company page you pass.", "default": 10 }, "maxCommentsPerPost": { "title": "Max commenters per post", "minimum": 1, "maximum": 200, "type": "integer", "description": "Cap per post. LinkedIn publishes roughly the top ten comments to logged-out visitors, so higher values rarely add more.", "default": 50 }, "maxResults": { "title": "Max results (whole run)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Total cap across every post. Set 0 for no limit (explicit opt-in).", "default": 100 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many profiles to enrich in parallel.", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "LinkedIn needs residential proxies for reliable logged-out access. Keep the default.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "urlsFromFile": { "title": "Import URLs from a file", "type": "string", "description": "Paste a list of URLs (one per line), OR one link to a .txt/.csv file, Google Sheet or Google Drive file containing them. Lets you import many Start URLs at once instead of typing each. Google Sheet/Drive share links are handled automatically." } } }, "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 } } } } } } } } } }