# 用户帖子

取一个 LinkedIn 用户发布的帖子，按游标翻页。

ID: native-http:social.linkedin.user.posts · Region: cn · Status: available

catalog_version: 5c920c774a55e44d7e8c709143b88a18b8b2afcef91a5d19a8c9ae5d565d9077
updated_at: 2026-10-21T12:06:16.523771+00:00

取一个 LinkedIn 用户发布的帖子，按游标翻页。

历史数据以数据集发布版本定义覆盖周期；实时读取反映请求时资料，不保证覆盖全部记录。

Docs: https://docs.asklear.cn/capabilities/native-http%3Asocial.linkedin.user.posts

## POST /v1/native/social/linkedin/users/posts

native · available · api_key

REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。

取一个 LinkedIn 用户发布的帖子，按游标翻页。

按成功请求计费，每次请求计一次；max_credits 限制本次费用上限。

恢复同一次原生请求时复用原 Idempotency-Key。

等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。

### Input schema / 输入契约

```json
{
  "$defs": {
    "Schema1": {}
  },
  "additionalProperties": false,
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "cursor": {
          "default": "",
          "description": "翻页偏移，第 1 页 0、第 2 页 50/Pagination offset",
          "maxLength": 4096,
          "type": "string"
        },
        "pagination_token": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "上一次响应返回的翻页令牌/Pagination token"
        },
        "start": {
          "anyOf": [
            {
              "minimum": 0,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "description": "翻页偏移，第 1 页 0、第 2 页 50/Pagination offset"
        },
        "type": {
          "default": "posts",
          "description": "posts（发帖/转发）| comments（评论过的帖子）| reactions（点赞过的帖子）",
          "type": "string"
        },
        "url": {
          "description": "用户主页 URL/Profile URL",
          "maxLength": 512,
          "minLength": 1,
          "pattern": "^https://([A-Za-z0-9-]+\\.)*linkedin\\.com/",
          "type": "string"
        }
      },
      "required": [
        "url"
      ],
      "type": "object"
    },
    "max_credits": {
      "anyOf": [
        {
          "maximum": 1000000000,
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "task_query": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional task attribution: when provided, write one concise, self-contained task_query in the user's language and reuse that exact value in every call for the task, including discovery, search, approval retry, results, export, and status checks. For MCP calls, when omitted, Asklear records a generic non-user-specific attribution so compatible clients can still call the tool. REST calls may omit it and remain unattributed. It is a task description, not a task identifier. Do not include hidden reasoning, credentials, or direct personal identifiers such as phone numbers, email addresses, identity numbers, or street addresses.",
          "maxLength": 300
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}
```

### Synthetic request / 合成请求

```json
{
  "input": {
    "url": "https://www.linkedin.com/in/example"
  }
}
```

### Response schema / 响应契约

```json
{
  "$defs": {
    "Schema1": {},
    "Schema2": {
      "properties": {
        "api_name": {
          "type": "string"
        },
        "credits_charged": {
          "minimum": 0,
          "type": "integer"
        },
        "latency_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_input": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "cursor": {
                  "default": "",
                  "maxLength": 4096,
                  "type": "string"
                },
                "pagination_token": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "上一次响应返回的翻页令牌/Pagination token"
                },
                "start": {
                  "anyOf": [
                    {
                      "minimum": 0,
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "翻页偏移，第 1 页 0、第 2 页 50/Pagination offset"
                },
                "type": {
                  "default": "posts",
                  "description": "posts（发帖/转发）| comments（评论过的帖子）| reactions（点赞过的帖子）",
                  "type": "string"
                },
                "url": {
                  "maxLength": 512,
                  "minLength": 1,
                  "pattern": "^https://([A-Za-z0-9-]+\\.)*linkedin\\.com/",
                  "type": "string"
                }
              },
              "required": [
                "url"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "request_id": {
          "type": "string"
        }
      },
      "required": [
        "api_name",
        "request_id",
        "latency_ms",
        "credits_charged",
        "next_input"
      ],
      "type": "object"
    }
  },
  "properties": {
    "data": {
      "additionalProperties": true,
      "description": "Known optional fields from sanitized offline fixtures; conditional fields may be null. Additional business fields are retained.",
      "properties": {
        "code": {
          "type": [
            "integer",
            "null"
          ]
        },
        "data": {
          "additionalProperties": true,
          "properties": {
            "data": {
              "items": {
                "additionalProperties": true,
                "properties": {
                  "article_subtitle": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "article_target_url": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "article_title": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "attributes": {
                    "items": {
                      "additionalProperties": true,
                      "properties": {
                        "company_id": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "first": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "headline": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "last": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "name": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "public_id": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "type": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "urn": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "type": [
                      "array",
                      "null"
                    ]
                  },
                  "images": {
                    "items": {
                      "description": "Observed as null; the non-null type is not established."
                    },
                    "type": [
                      "array",
                      "null"
                    ]
                  },
                  "num_appreciations": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "num_comments": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "num_empathy": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "num_entertainments": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "num_interests": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "num_likes": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "num_praises": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "num_reactions": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "num_reposts": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "post_url": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "posted": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "poster": {
                    "additionalProperties": true,
                    "properties": {
                      "first": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "headline": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "image_url": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "last": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "linkedin_url": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "public_id": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "urn": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "poster_linkedin_url": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "repost_stats": {
                    "additionalProperties": true,
                    "properties": {
                      "num_appreciations": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "num_comments": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "num_empathy": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "num_entertainments": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "num_interests": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "num_likes": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "num_maybe": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "num_praises": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "num_reactions": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "num_reposts": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      }
                    },
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "repost_urn": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "reposted": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "reshared": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "resharer_comment": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "share_urn": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "text": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "time": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "urn": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "video": {
                    "additionalProperties": true,
                    "properties": {
                      "duration": {
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "stream_url": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "type": [
                      "object",
                      "null"
                    ]
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "type": [
                "array",
                "null"
              ]
            },
            "paging": {
              "additionalProperties": true,
              "properties": {
                "count": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "pagination_token": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "start": {
                  "type": [
                    "integer",
                    "null"
                  ]
                }
              },
              "type": [
                "object",
                "null"
              ]
            }
          },
          "type": [
            "object",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "meta": {
      "$ref": "#/$defs/Schema2"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "type": "object"
}
```

### Synthetic response / 合成响应

```json
{
  "data": {
    "code": 200,
    "data": {
      "data": [
        {
          "article_subtitle": "fixture_svangel.com",
          "article_target_url": "https://fixture.invalid/media/1",
          "article_title": "fixture_project blueprin",
          "attributes": [
            {
              "company_id": "1522847",
              "name": "fixture_sv angel",
              "public_id": "fixture_sv-angel",
              "type": "fixture_company"
            }
          ],
          "images": [],
          "num_comments": 1,
          "num_interests": 1,
          "num_likes": 10,
          "num_praises": 1,
          "num_reactions": 12,
          "num_reposts": 2,
          "post_url": "https://fixture.invalid/media/1",
          "posted": "2026-03-04 05:06:07",
          "poster_linkedin_url": "https://fixture.invalid/media/1",
          "repost_stats": {
            "num_appreciations": 4,
            "num_comments": 23,
            "num_empathy": 5,
            "num_entertainments": 1,
            "num_interests": 2,
            "num_likes": 101,
            "num_maybe": 0,
            "num_praises": 3,
            "num_reactions": 116,
            "num_reposts": 11
          },
          "repost_urn": "7505813874869399552",
          "reposted": "2026-03-04 05:06:07",
          "reshared": true,
          "resharer_comment": "合成正文 <em>highlight</em> fixture body 用于覆盖 _strip_markup",
          "share_urn": "7505335864160358400",
          "text": "合成正文 <em>highlight</em> fixture body 用于覆盖 _strip_markup",
          "time": "fixture_1 day ago",
          "urn": "7505335865892605952"
        }
      ],
      "paging": {
        "count": 50,
        "pagination_token": "FIXTURE_CURSOR_TOKEN_0123456789abcdef",
        "start": 0
      }
    }
  },
  "meta": {
    "api_name": "social.linkedin.user.posts",
    "credits_charged": 84,
    "latency_ms": 12,
    "next_input": {
      "cursor": "{\"after\":\"FIXTURE_CURSOR_TOKEN_0123456789abcdef\",\"k\":\"https://www.linkedin.com/in/williamhgates\",\"r\":\"\",\"s\":\"\",\"t\":\"user_posts\"}",
      "url": "https://www.linkedin.com/in/williamhgates"
    },
    "request_id": "asklear-example"
  }
}
```

- data (object): Known optional fields from sanitized offline fixtures; conditional fields may be null. Additional business fields are retained.
- data.code (integer|null): 暂无字段说明
- data.data (object|null): 暂无字段说明
- data.data.data (array|null): 暂无字段说明
- data.data.paging (object|null): 暂无字段说明
- data.data.paging.count (integer|null): 暂无字段说明
- data.data.paging.pagination_token (string|null): 暂无字段说明
- data.data.paging.start (integer|null): 暂无字段说明
- meta (object): 暂无字段说明
- meta.api_name (string): 暂无字段说明
- meta.request_id (string): 暂无字段说明
- meta.latency_ms (integer): 暂无字段说明
- meta.credits_charged (integer): 暂无字段说明
- meta.next_input (scalar): 暂无字段说明
- data.data.data[].article_subtitle (string|null): 暂无字段说明
- data.data.data[].article_target_url (string|null): 文章链接（如有）。
- data.data.data[].article_title (string|null): 文章标题（如有）。
- data.data.data[].attributes (array|null): 暂无字段说明
- data.data.data[].attributes[].company_id (string|null): 暂无字段说明
- data.data.data[].attributes[].first (string|null): 暂无字段说明
- data.data.data[].attributes[].headline (string|null): 暂无字段说明
- data.data.data[].attributes[].last (string|null): 暂无字段说明
- data.data.data[].attributes[].name (string|null): 暂无字段说明
- data.data.data[].attributes[].public_id (string|null): 暂无字段说明
- data.data.data[].attributes[].type (string|null): 暂无字段说明
- data.data.data[].attributes[].urn (string|null): 暂无字段说明
- data.data.data[].images (array|null): 暂无字段说明
- data.data.data[].num_appreciations (integer|null): 暂无字段说明
- data.data.data[].num_comments (integer|null): 评论数（如有）。
- data.data.data[].num_empathy (integer|null): 暂无字段说明
- data.data.data[].num_entertainments (integer|null): 暂无字段说明
- data.data.data[].num_interests (integer|null): 暂无字段说明
- data.data.data[].num_likes (integer|null): 点赞数（如有）。
- data.data.data[].num_praises (integer|null): 暂无字段说明
- data.data.data[].num_reactions (integer|null): 暂无字段说明
- data.data.data[].num_reposts (integer|null): 转发数（如有）。
- data.data.data[].post_url (string|null): 公开链接（如有）。
- data.data.data[].posted (string|null): 发布时间（如有）。
- data.data.data[].poster (object|null): 暂无字段说明
- data.data.data[].poster.first (string|null): 暂无字段说明
- data.data.data[].poster.headline (string|null): 暂无字段说明
- data.data.data[].poster.image_url (string|null): 暂无字段说明
- data.data.data[].poster.last (string|null): 暂无字段说明
- data.data.data[].poster.linkedin_url (string|null): 作者链接（如有）。
- data.data.data[].poster.public_id (string|null): 暂无字段说明
- data.data.data[].poster.urn (string|null): 暂无字段说明
- data.data.data[].poster_linkedin_url (string|null): 作者链接（如有）。
- data.data.data[].repost_stats (object|null): 暂无字段说明
- data.data.data[].repost_stats.num_appreciations (integer|null): 暂无字段说明
- data.data.data[].repost_stats.num_comments (integer|null): 暂无字段说明
- data.data.data[].repost_stats.num_empathy (integer|null): 暂无字段说明
- data.data.data[].repost_stats.num_entertainments (integer|null): 暂无字段说明
- data.data.data[].repost_stats.num_interests (integer|null): 暂无字段说明
- data.data.data[].repost_stats.num_likes (integer|null): 暂无字段说明
- data.data.data[].repost_stats.num_maybe (integer|null): 暂无字段说明
- data.data.data[].repost_stats.num_praises (integer|null): 暂无字段说明
- data.data.data[].repost_stats.num_reactions (integer|null): 暂无字段说明
- data.data.data[].repost_stats.num_reposts (integer|null): 暂无字段说明
- data.data.data[].repost_urn (string|null): 暂无字段说明
- data.data.data[].reposted (string|null): 是否转发（如有）。
- data.data.data[].reshared (boolean|null): 是否再次分享（如有）。
- data.data.data[].resharer_comment (string|null): 暂无字段说明
- data.data.data[].share_urn (string|null): 暂无字段说明
- data.data.data[].text (string|null): 正文内容（如有）。
- data.data.data[].time (string|null): 暂无字段说明
- data.data.data[].urn (string|null): 帖子 ID（如有）。
- data.data.data[].video (object|null): 暂无字段说明
- data.data.data[].video.duration (integer|null): 暂无字段说明
- data.data.data[].video.stream_url (string|null): 暂无字段说明
- meta.next_input.cursor (string): 暂无字段说明
- meta.next_input.pagination_token (string|null): 上一次响应返回的翻页令牌/Pagination token
- meta.next_input.start (integer|null): 翻页偏移，第 1 页 0、第 2 页 50/Pagination offset
- meta.next_input.type (string): posts（发帖/转发）| comments（评论过的帖子）| reactions（点赞过的帖子）
- meta.next_input.url (string): 暂无字段说明

Follow up: GET /v1/native/results/{query_id}
读取已保存结果，不重复查询数据或收费。

