{ "openapi": "3.0.1", "info": { "title": "LinkedIn Top Voice & Competitor Activity Monitor", "description": "Profile the content strategy behind any LinkedIn person or company page: how often they post, what format they use, which hashtags they lean on, and which choices actually earn engagement on their audience. No login and no cookie required.", "version": "0.0", "x-build-id": "BfUX4E3MtWle4YFdw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fanndev~linkedin-competitor-activity-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fanndev-linkedin-competitor-activity-monitor", "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/fanndev~linkedin-competitor-activity-monitor/runs": { "post": { "operationId": "runs-sync-fanndev-linkedin-competitor-activity-monitor", "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/fanndev~linkedin-competitor-activity-monitor/run-sync": { "post": { "operationId": "run-sync-fanndev-linkedin-competitor-activity-monitor", "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": "Member profiles", "type": "array", "description": "People to profile - industry influencers, competitors' founders, your own team. A full /in/ URL or just the handle both work.", "items": { "type": "string" } }, "companyUrls": { "title": "Company pages", "type": "array", "description": "Company or showcase pages to profile. A full /company/ URL or just the slug both work. Note that LinkedIn blocks /school/ pages entirely for logged-out visitors, so universities cannot be monitored this way.", "items": { "type": "string" } }, "startUrls": { "title": "Company pages (request list)", "type": "array", "description": "The same company links in the request-list format, for callers that already keep one.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxPostsPerAccount": { "title": "Maximum posts per account", "minimum": 1, "maximum": 50, "type": "integer", "description": "Cap on posts analysed per account. LinkedIn embeds roughly the last 6-10 posts on a logged-out page regardless of what you ask for, so values above that change nothing - the ceiling is LinkedIn's, not this actor's.", "default": 25 }, "minReactions": { "title": "Ignore posts below this many reactions", "minimum": 0, "type": "integer", "description": "Drop low-performing posts before the metrics are computed. Useful for asking 'what does their good content look like' rather than 'what is their average'.", "default": 0 }, "fetchPostEngagement": { "title": "Fetch real engagement for company posts", "type": "boolean", "description": "Company pages embed their posts WITHOUT any engagement data, while member profiles embed it. Turn this on to open each company post's own permalink and read its true reaction and comment counts - one extra request per post. Leave it off and company engagement metrics stay null rather than being reported as zero.", "default": false }, "emitPostRecords": { "title": "Also emit one row per post", "type": "boolean", "description": "Write each analysed post as its own POST row: text, publish date, reactions, hashtags, media type and length.", "default": true }, "minDelaySeconds": { "title": "Minimum delay between requests", "minimum": 0, "maximum": 60, "type": "integer", "description": "LinkedIn answers request bursts with HTTP 999 and a near-empty page - three back-to-back requests were enough to trip it in testing. A randomised gap is what keeps a run under that gate.", "default": 3 }, "maxDelaySeconds": { "title": "Maximum delay between requests", "minimum": 0, "maximum": 120, "type": "integer", "description": "The ceiling of the randomised gap. Raise both bounds if the log shows rate-gate warnings.", "default": 8 }, "exportFormats": { "title": "Extra export files", "type": "array", "description": "Besides the dataset, write ready-made files into this run's key-value store.", "items": { "type": "string", "enum": [ "json", "ndjson", "csv", "excel" ], "enumTitles": [ "JSON", "NDJSON", "CSV", "Excel (XLSX)" ] }, "default": [] }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. These pages carry no WAF and Apify's datacenter range reaches them, but LinkedIn's per-IP rate gate is real - a proxy helps most when you are monitoring many accounts in one run.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }