> ## 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 个人帖子 > 采集并标准化公开的 LinkedIn 个人帖子。 # LinkedIn 个人帖子 ```json theme={"system"} { "urls": [ "https://www.linkedin.com/in/satyanadella/" ], "only_authored_posts": true, "results_limit": 20 } ``` ## 结果字段 任务结果使用下列稳定的 SocQ 字段。来源特有的字段名称和格式会被规范化，但不会推断或补充来源未提供的值。如需请求更小的字段集，MCP 查询请使用 `fields`，Typed 工具请使用 `_result_fields`，CLI 请使用 `--result-fields`。即使值为 `null`，已声明的字段仍会保留。 | 字段 | 类型 | 可空 | 说明 | | ------------------------ | --------------- | -- | ---------------------------------------- | | `id` | `string` | 是 | 当前结果项的唯一标识。 | | `platform` | `string` | 否 | 结果所属的平台，例如 `instagram` 或 `linkedin`。 | | `resource` | `string` | 否 | 该结果对应的 SocQ 资源，例如 `videos` 或 `comments`。 | | `type` | `string` | 否 | 结果项的类别，例如 `video`、`post` 或 `comment`。 | | `url` | `string` | 是 | 结果项的公开访问地址（如可获得）。 | | `published_at` | `string` | 是 | 源内容的发布时间（如可获得），使用 ISO 8601 格式。 | | `collected_at` | `string` | 否 | SocQ 采集或处理该结果的时间，使用 ISO 8601 格式。 | | `text` | `string` | 是 | 帖子的正文、说明文字或消息内容。 | | `author` | `object` | 是 | 内容的作者或发布者。 | | `author.id` | `string` | 是 | 作者的唯一标识。 | | `author.username` | `string` | 是 | 账号的公开用户名或账号标识。 | | `author.name` | `string` | 是 | 作者的显示名称。 | | `author.url` | `string` | 是 | 作者的公开访问地址（如可获得）。 | | `author.avatar_url` | `string` | 是 | 账号头像图片的地址。 | | `author.is_verified` | `boolean` | 是 | 账号是否已通过平台认证。 | | `author.is_private` | `boolean` | 是 | 账号是否为私密账号。 | | `metrics` | `object` | 是 | 结果项可获得的计数和度量数据。 | | `metrics.likes_count` | `integer` | 是 | 点赞数量。 | | `metrics.comments_count` | `integer` | 是 | 评论数量。 | | `metrics.shares_count` | `integer` | 是 | 分享或转发数量。 | | `metrics.views_count` | `integer` | 是 | 平台报告的观看数量。 | | `media` | `array` | 是 | 结果附带的图片、视频或其他媒体。 | | `media.type` | `string` | 是 | 媒体类型，例如 `image` 或 `video`。 | | `media.url` | `string` | 是 | 媒体文件的地址。 | | `media.thumbnail_url` | `string` | 是 | 媒体预览图的地址。 | | `media.width` | `integer` | 是 | 媒体宽度，单位为像素。 | | `media.height` | `integer` | 是 | 媒体高度，单位为像素。 | | `media.duration_seconds` | `number` | 是 | 媒体时长，单位为秒。 | | `hashtags` | `array` | 是 | 内容关联的话题标签，保留源数据中的拼写。 | | `mentions` | `array` | 是 | 内容中提及的账号。 | ## 任务完成响应 ```json theme={"system"} { "code": 200, "data": { "task_id": "9TM461Z3P8E84O3A", "status": "succeeded", "public_id": "linkedin/profile-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": "7488406960443183104", "platform": "linkedin", "resource": "profile-posts", "type": "post", "url": "https://www.linkedin.com/posts/satyanadella_some-more-detail-on-the-roic-intelligence-activity-7488406960443183104-g52O", "published_at": "2026-07-30T01:35:47.220000Z", "collected_at": "2026-08-11T03:03:36.453564Z", "text": "Some more detail on the ROIC Intelligence App I built yesterday and mentioned on today's earnings call.", "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": 7792, "comments_count": 424, "shares_count": null, "views_count": null }, "media": [ { "type": "image", "url": "https://media.licdn.com/dms/image/v2/D5622AQES105T-agpcQ/feedshare-shrink_800", "thumbnail_url": null, "width": null, "height": null, "duration_seconds": null } ], "hashtags": null, "mentions": null } ] } } } ``` ## 与 MCP 和 CLI 一起使用 | 接口 | 值 | | ----------- | ----------------------------------------------------- | | REST | `POST /v1/linkedin/profile-posts` | | Compact MCP | `socq_execute` 与 `endpoint: "linkedin/profile-posts"` | | Typed MCP | `socq_linkedin_profile_posts` | | CLI | `socq linkedin profile-posts` | 该接口使用异步任务流程并返回 `task_id`。轮询任务接口以读取标准化结果。 ## OpenAPI ````yaml zh/api-manual/agent-api/agent-api.json POST /v1/linkedin/profile-posts openapi: 3.1.0 info: title: SocQ Agent API 中文版 version: v1-c051f5df2885 description: 根据 SocQ 能力目录生成的异步社交数据 API。 servers: - url: https://api.socq.ai security: [] paths: /v1/linkedin/profile-posts: post: tags: - linkedin summary: LinkedIn 个人帖子 description: 采集并标准化公开的 LinkedIn 个人帖子。 operationId: socq_linkedin_profile_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 description: 筛选结束日期，格式为 YYYY-MM-DD。 only_authored_posts: type: boolean description: 请求参数。 results_limit: type: integer minimum: 1 maximum: 2000 default: 100 description: 最多保存的结果数，实际结果可能少于该值。 start_date: type: string minLength: 1 description: 筛选开始日期，格式为 YYYY-MM-DD。 urls: type: array items: type: string minLength: 1 description: 公开内容、主页或商品 URL 列表。每个 URL 分别应用结果数量上限，至少提供 1 项。 required: - urls responses: '200': description: 任务已受理 content: application/json: schema: $ref: '#/components/schemas/AgentSubmitResponse' security: - bearerAuth: [] - apiKeyAuth: [] components: schemas: AgentSubmitResponse: type: object properties: code: type: integer const: 200 description: HTTP 业务状态码。 data: type: object properties: task_id: type: string description: 任务 ID，用于查询任务状态和结果。 status: type: string description: 任务当前状态。 created_time: type: - string - 'null' description: 任务创建时间。 idempotent_replay: type: boolean description: 是否复用了由相同 Idempotency-Key 创建的已有任务。false 表示新任务，true 表示重复提交返回原任务。 required: - task_id - status securitySchemes: bearerAuth: type: http scheme: bearer description: '使用 `Authorization: Bearer ` 请求头进行身份验证。' apiKeyAuth: type: apiKey in: header name: x-api-key description: 也可以通过 `x-api-key` 请求头提供 API Key。 ````