{ "openapi": "3.0.1", "info": { "title": "LinkedIn Post Reports Scraper", "description": "Scrape public LinkedIn post reports from post URLs: likes, comments, author, media, and engagement rate. Use for content analytics and competitor reporting. For commenter identities, continue with linkedin-post-engagers-scraper. Returns one report per post. Charged $0.008 per report.", "version": "0.1", "x-build-id": "9dgbfKP3Y6YHY7Akm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~linkedin-post-reports-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-linkedin-post-reports-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/khadinakbar~linkedin-post-reports-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-linkedin-post-reports-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/khadinakbar~linkedin-post-reports-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-linkedin-post-reports-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", "required": [ "postUrls" ], "properties": { "postUrls": { "title": "LinkedIn post URLs", "maxItems": 200, "type": "array", "description": "Public LinkedIn post URLs to turn into one engagement report each. Accepts activity URLs such as https://www.linkedin.com/feed/update/urn:li:activity:7468770468041502720/, posts URLs, and pulse article URLs. Up to 200 unique URLs per run; duplicates are merged. Profile and company page URLs belong in a profile or company posts scraper.", "items": { "type": "string" } }, "maxPosts": { "title": "Maximum reports", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard cap on billable post-report rows for this run. Default 50 keeps agent and quality-test calls small. Prefill 1 is the cheapest one-post check. Values above 200 are clamped.", "default": 50 }, "includeCommentsPreview": { "title": "Include comments preview", "type": "boolean", "description": "When enabled, each report includes up to maxCommentsPreview visible public comments from the same post payload. Default true. This uses the post detail already fetched, so it does not add a second provider call. Set false when you only need counts and author fields.", "default": true }, "maxCommentsPreview": { "title": "Max comments in preview", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many public comments to attach on each report row. Default 5 matches what public post payloads typically expose. Zero stores counts only. Full commenter lead lists belong in the LinkedIn Post Engagers Scraper.", "default": 5 }, "providerOrder": { "title": "Data provider order", "enum": [ "scrapecreators-first", "sociavault-first" ], "type": "string", "description": "Which public-data provider to try first for each post URL. Both providers return the same report shape. The second provider runs automatically when the first misses or returns an empty payload. Keep the default unless you have a reason to prefer SociaVault.", "default": "scrapecreators-first" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many post URLs to process in parallel. Default 2 balances speed against provider rate limits. Raise to 5 for large batches. Lower to 1 when a run log shows provider rate-limit warnings.", "default": 2 } } }, "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 } } } } } } } } } }