{ "openapi": "3.0.1", "info": { "title": "LinkedIn Post Scraper: Posting Cadence Analytics", "description": "Scrape LinkedIn posts with text, images, authors, timestamps, reactions, comments, and engagement metrics. Ideal for market research, lead insights, competitor analysis, trend tracking, and content monitoring for recruiters, marketers, sales teams, and analysts.", "version": "0.1", "x-build-id": "qsMbSWdyWP8DT21Ug" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~linkedin-post-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-linkedin-post-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/scrapier~linkedin-post-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-linkedin-post-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/scrapier~linkedin-post-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-linkedin-post-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": { "profileUrls": { "title": "🗓️ Company / person / post URLs", "type": "array", "description": "LinkedIn company, person, or post permalink URLs whose posting cadence you want to measure — one or many. Example: https://www.linkedin.com/company/google/. Bare company slugs (e.g. \"google\") are accepted too.", "items": { "type": "string" } }, "postsPerSource": { "title": "📈 Posts to analyze per source", "minimum": 1, "type": "integer", "description": "How many recent posts to collect and feed into the cadence roll-up for each URL. More posts = a more accurate cadence. Example: 20. Default is 15.", "default": 15 }, "oldestDate": { "title": "📅 Oldest post date (from)", "type": "string", "description": "Only include posts created on/after this date, matched against the EXACT URN-decoded creation time. Accepts an absolute date (2026-01-01) or a relative value (\"30 days\", \"3 months\"). Leave empty for no lower bound." }, "newestDate": { "title": "📅 Newest post date (to)", "type": "string", "description": "Only include posts created on/before this date (exact URN-decoded time). Absolute (2026-06-30) or relative (\"7 days\"). Leave empty for no upper bound." }, "includeCadenceSummary": { "title": "📊 Add per-source cadence summary row", "type": "boolean", "description": "Append one cadence-summary row per source with postsPerWeek, avgGapDays, mostActiveDay/Hour, longestGapDays and freshness buckets. Turn off to get only the individual post rows. Default is true.", "default": true }, "crawlLinkedGraph": { "title": "🔍 Crawl the linked post graph", "type": "boolean", "description": "Follow post URNs discovered on the first page to collect more posts (BFS crawl). Recommended for a fuller cadence sample. Turn off to read only the posts inline on the source page. Default is true.", "default": true }, "advancedOptions": { "title": "⚙️ Advanced options", "type": "boolean", "description": "Show advanced settings below.", "default": false }, "rawData": { "title": "📦 Include raw HTML (debug)", "type": "boolean", "description": "Attach the source HTML to each row for debugging. Leave off for clean output. Default is false.", "default": false }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Optional proxy for reliability and to reduce rate-limiting." } } }, "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 } } } } } } } } } }