> ## Documentation Index > Fetch the complete documentation index at: https://docs.socq.ai/llms.txt > Use this file to discover all available pages before exploring further. # LinkedIn Company Posts > Collect normalized public linkedin company posts data. # LinkedIn Company Posts ```json theme={"system"} { "urls": [ "https://www.linkedin.com/company/microsoft/" ], "results_limit": 20 } ``` ## Result Fields Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use `fields` for MCP queries, `_result_fields` for typed tools, or `--result-fields` in the CLI. Declared fields remain present when their value is `null`. | Field | Type | Nullable | Description | | ------------------------ | --------------- | -------- | ----------------------------------------------------------------------------- | | `id` | `string` | Yes | Unique identifier for this result item. | | `platform` | `string` | No | Platform the result belongs to, such as `instagram` or `linkedin`. | | `resource` | `string` | No | SocQ resource represented by the result, such as `videos` or `comments`. | | `type` | `string` | No | Category of the result item, such as `video`, `post`, or `comment`. | | `url` | `string` | Yes | Public URL of the result item when available. | | `published_at` | `string` | Yes | Time the source item was published, in ISO 8601 format when available. | | `collected_at` | `string` | No | Time SocQ collected or processed this result, in ISO 8601 format. | | `text` | `string` | Yes | Post body, caption, or message. | | `author` | `object` | Yes | Author or publisher of the content. | | `author.id` | `string` | Yes | Unique identifier of the author. | | `author.username` | `string` | Yes | Public username or handle of the account. | | `author.name` | `string` | Yes | Display name of the author. | | `author.url` | `string` | Yes | Public URL of the author when available. | | `author.avatar_url` | `string` | Yes | URL of the account avatar image. | | `author.is_verified` | `boolean` | Yes | Whether the account is verified on the platform. | | `author.is_private` | `boolean` | Yes | Whether the account is private. | | `metrics` | `object` | Yes | Counters and measurements available for the result item. | | `metrics.likes_count` | `integer` | Yes | Number of likes. | | `metrics.comments_count` | `integer` | Yes | Number of comments. | | `metrics.shares_count` | `integer` | Yes | Number of shares or reposts. | | `metrics.views_count` | `integer` | Yes | Number of views reported by the platform. | | `media` | `array` | Yes | Images, videos, or other media attached to the result. | | `media.type` | `string` | Yes | Media kind, such as `image` or `video`. | | `media.url` | `string` | Yes | URL of the media asset. | | `media.thumbnail_url` | `string` | Yes | URL of the media preview image. | | `media.width` | `integer` | Yes | Media width in pixels. | | `media.height` | `integer` | Yes | Media height in pixels. | | `media.duration_seconds` | `number` | Yes | Media duration in seconds. | | `hashtags` | `array` | Yes | Hashtags associated with the content, without changing their source spelling. | | `mentions` | `array` | Yes | Accounts mentioned in the content. | ## Completed Task Response ```json theme={"system"} { "code": 200, "data": { "task_id": "GHBLOIQT5WQ03X09", "status": "succeeded", "public_id": "linkedin/company-posts", "result_count": 1, "credits_amount": 1, "results": { "limit": 50, "next_cursor": null, "has_more": false, "schema_id": "post", "schema_version": "1.0", "items": [ { "id": "7488370638122807296", "platform": "linkedin", "resource": "company-posts", "type": "post", "url": "https://www.linkedin.com/posts/microsoft_activity-7488370638122807296-vIdk", "published_at": "2026-07-29T23:11:27.327000Z", "collected_at": "2026-08-11T03:03:36.399361Z", "text": "Just wrapped our earnings call. It was a very strong close to what was a record fiscal year for Microsoft.", "author": { "id": "satyanadella", "username": null, "name": "Satya Nadella", "url": "https://www.linkedin.com/in/satyanadella", "avatar_url": null, "is_verified": null, "is_private": null }, "metrics": { "likes_count": 11310, "comments_count": 477, "shares_count": null, "views_count": null }, "media": [], "hashtags": null, "mentions": null } ] } } } ``` ## Use with MCP and CLI | Interface | Value | | ----------- | -------------------------------------------------------- | | REST | `POST /v1/linkedin/company-posts` | | Compact MCP | `socq_execute` with `endpoint: "linkedin/company-posts"` | | Typed MCP | `socq_linkedin_company_posts` | | CLI | `socq linkedin company-posts` | The endpoint uses the asynchronous task flow and returns a task\_id. Poll the task endpoint to read normalized results. ## OpenAPI ````yaml api-manual/agent-api/agent-api.json POST /v1/linkedin/company-posts openapi: 3.1.0 info: title: SocQ Agent API version: v1-c051f5df2885 description: Asynchronous social data API generated from the SocQ Capability Registry. servers: - url: https://api.socq.ai security: [] paths: /v1/linkedin/company-posts: post: tags: - linkedin summary: Get LinkedIn Company Posts description: Fetch normalized company posts data from LinkedIn. operationId: socq_linkedin_company_posts requestBody: required: true content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object additionalProperties: false properties: end_date: type: string minLength: 1 results_limit: type: integer minimum: 1 maximum: 2000 default: 100 start_date: type: string minLength: 1 urls: type: array items: type: string minLength: 1 minItems: 1 description: Public profile or content URLs. required: - urls responses: '200': description: Task accepted content: application/json: schema: $ref: '#/components/schemas/AgentSubmitResponse' security: - bearerAuth: [] - apiKeyAuth: [] components: schemas: AgentSubmitResponse: type: object properties: code: type: integer const: 200 data: type: object properties: task_id: type: string status: type: string created_time: type: - string - 'null' idempotent_replay: type: boolean required: - task_id - status securitySchemes: bearerAuth: type: http scheme: bearer apiKeyAuth: type: apiKey in: header name: x-api-key ````