{ "openapi": "3.0.1", "info": { "title": "LinkedIn Group Posts Scraper — Public Groups, New Posts Only", "description": "LinkedIn group posts from any PUBLIC group link as rows — the group, post text, a real publish timestamp, likes, comments, shares, reactions, media and article links, and the member who posted. No login, no cookies. A daily run returns only new posts; a private group is never charged.", "version": "1.0", "x-build-id": "BHkcEMj9cjH8PEFtI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steadyfetch~linkedin-group-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steadyfetch-linkedin-group-posts-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/steadyfetch~linkedin-group-posts-scraper/runs": { "post": { "operationId": "runs-sync-steadyfetch-linkedin-group-posts-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/steadyfetch~linkedin-group-posts-scraper/run-sync": { "post": { "operationId": "run-sync-steadyfetch-linkedin-group-posts-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": { "startUrls": { "title": "LinkedIn group URLs", "type": "array", "description": "Public LinkedIn group links, one per line — https://www.linkedin.com/groups// (the old /groups/-/ form, a group post link and the bare number work too). A private group comes back as an uncharged row: LinkedIn shows its posts to members only. A profile or company page is refused with a pointer to the actor that reads it. Also answers to `urls`, `links`, `groupUrls` and `groups`. Leave it empty and click Start for a small built-in sample that charges nothing.", "items": { "type": "string" } }, "postsPerTarget": { "title": "Max posts per group", "type": "integer", "description": "Hard cap on the posts delivered for EACH group — three groups at 100 collect up to 300 in total. Any number from 1 to 500 is used exactly as typed, and only delivered posts are charged (plus one group check per group read); a number above 500 is moved to 500 and one uncharged row says so. A group that runs short leaves an uncharged row saying so. Also answers to `postsPerGroup`, `resultsLimit`, `limit`, `count`, `maxPosts` and `maxResults`; the smallest limit present binds.", "default": 100 }, "maxItems": { "title": "Max posts for the whole run", "type": "integer", "description": "Hard ceiling across every group in the run, whatever the per-group limit says — between 1 and 100,000, and a number outside that is moved to the nearest end on an uncharged row instead of the run being refused. Leave it empty for 1,000. The smallest limit present binds, and one uncharged note row says which name was read and what it was read as.", "default": 1000 }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Keep only posts published on or after this moment: a date (2026-08-01, 1 Aug 2026, or 01.08.2026 day first) or a span counted back from now (24h, 7 days, 2 weeks, 3 months, 1 year, 7d, last month, today, yesterday). LinkedIn lists a group's posts newest first, so the read stops once a page is mostly older than this — a narrow window costs less, not more." }, "postedBefore": { "title": "Posted before", "type": "string", "description": "Keep only posts published before this moment: a date (2026-09-01, 1 Sep 2026, or 01.09.2026 day first) or a span counted back from now (24h, 7 days, 2 weeks, 3 months, 1 year, 7d, last month, today, yesterday), the same forms as \"Posted after\". Pair it with \"Posted after\" for a closed window. A post outside the window is dropped before it takes a slot, so it is never delivered and never charged." }, "includeReposts": { "title": "Include reposts", "type": "boolean", "description": "ON (default): a repost shared into the group is delivered as a row marked `isRepost: true`, carrying the original post's id, link, author and its own publish time. OFF: reposts are dropped before they take a slot.", "default": true }, "maxRunSeconds": { "title": "Max run seconds", "type": "integer", "description": "The run stops cleanly before this many seconds and reports what is left, instead of being killed by a timeout — between 30 and 7,200, and a number outside that is moved to the nearest end on an uncharged row. A time limit ends the collecting, never the delivering: posts already in hand are always written out.", "default": 1800 }, "includeSeen": { "title": "Include posts you already have", "type": "boolean", "description": "OFF (default): a post already delivered to your account is skipped — no row, no charge. LinkedIn lists a group's posts newest first, so once a page shows posts you already have the run reads no older page for that group: you get what is new since your last run, and the rest of the number you asked for closes on one uncharged `skipped.all_repeat` row. A group that had nothing new for your account is not read again for up to 24 hours under the same dates and the same setting, and one uncharged row says when. ON: those posts are delivered again, marked `repeat: true`, still not charged, and the run keeps reading older pages. Posts older than 90 days in your account's memory count as new again.", "default": false }, "resumeFromDatasetId": { "title": "Skip posts in this dataset", "type": "string", "description": "The dataset ID of a previous run of this actor. Posts already in it are treated as posts you already have and are skipped, so a follow-up run collects only what is new even from a different Apify account. Selecting it here is what grants this run permission to read it." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }