> ## 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.

# Reddit 用户帖子

> 获取 Reddit 账号发布过的帖子。

# Reddit 用户帖子

拉取一个 Reddit 用户发过的所有帖子：文字帖的完整正文、帖子链接、分数、评论数、发布时间，以及帖子里的图片和视频。按最新排序可以跟踪对方最近在分享什么，按热度排序可以看哪些帖子反响最好。适合做创作者调研、盯创始人账号的品牌动态，或者把某位行业专家的长帖整理成数据集。

```json theme={"dark"}
{
  "username": "spez",
  "sort_by": "new",
  "results_limit": 25
}
```

通过 username 提供一个 Reddit 用户名。sort\_by 可选 new（默认，最新）、top（最高分）或 hot（热门）。results\_limit 默认 25，可填 1–1000 之间的整数。每条帖子计 0.5 积分；likes\_count 为帖子分数。

## 标准结果字段

任务结果使用下方稳定的 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<object>` | 是 | 结果附带的图片、视频或其他媒体。 |
| `media.type` | `string` | 是 | 媒体类型，例如 `image` 或 `video`。 |
| `media.url` | `string` | 是 | 媒体文件的地址。 |
| `media.thumbnail_url` | `string` | 是 | 媒体预览图的地址。 |
| `media.width` | `integer` | 是 | 媒体宽度，单位为像素。 |
| `media.height` | `integer` | 是 | 媒体高度，单位为像素。 |
| `media.duration_seconds` | `number` | 是 | 媒体时长，单位为秒。 |
| `hashtags` | `array<string>` | 是 | 内容关联的话题标签，保留源数据中的拼写。 |
| `mentions` | `array<string>` | 是 | 内容中提及的账号。 |

以下示例展示任务完成后的响应格式，具体数据以实际查询结果为准。

## 任务完成响应

```json theme={"dark"}
{
  "code": 200,
  "data": {
    "task_id": "example-reddit-user-posts",
    "status": "succeeded",
    "public_id": "reddit/user-posts",
    "result_count": 1,
    "credits_amount": 0.5,
    "results": {
      "limit": 50,
      "next_cursor": null,
      "has_more": false,
      "schema_id": "post",
      "schema_version": "1.0",
      "items": [
        {
          "id": "1xiupm0",
          "platform": "reddit",
          "resource": "user-posts",
          "type": "post",
          "url": "https://www.reddit.com/user/spez/comments/1xiupm0/about_that_login_screen/",
          "published_at": "2026-10-29T20:08:37.416000Z",
          "collected_at": "2026-11-17T14:40:28.299773Z",
          "text": "About that login screen\n\nI want to talk about a big change we're making on Reddit: we're going to evolve Reddit to being a primarily logged-in experience.\n\nThis is a big change for Reddit, where we've allowed logged-out access to basically all of Reddit for the last two decades. And I don’t know about you, but as someone whose life has been defined by the open internet, it’s a big change for me. But I've come to the conclusion that this is the right decision for our platform and the right decision for our business. I wanted you all to hear directly from me about why.\n\nTL;DR We’re making the change because it’s better for user experience, better for our ads business, is more in line with safety regulations, and more protective of Reddit data. And we can do this while continuing to ensure user privacy. \n\n**For users to get the best version of Reddit, it requires personalization.** …",
          "author": {
            "id": "t2_1w72",
            "username": "spez",
            "name": "spez",
            "url": "https://www.reddit.com/user/spez/",
            "avatar_url": "https://styles.redditmedia.com/t5_3k30p/styles/profileIcon_uj015iwx9s7g1.png?width=50&height=50&frame=1&auto=webp&crop=50%3A50%2Csmart&s=638708ec49d2051716871e62d0b8a9da3b11402c",
            "is_verified": null,
            "is_private": null
          },
          "metrics": {
            "likes_count": 0,
            "comments_count": 510,
            "shares_count": null,
            "views_count": null
          },
          "media": [],
          "hashtags": null,
          "mentions": null
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml zh/api-manual/agent-api/agent-api.json POST /v1/reddit/user-posts
openapi: 3.1.0
info:
  title: SocQ Agent API 中文版
  version: v1-87892a6484c2
  description: 根据 SocQ 能力目录生成的异步社交数据 API。
servers:
  - url: https://api.socq.ai
security: []
paths:
  /v1/reddit/user-posts:
    post:
      tags:
        - reddit
      summary: Reddit 用户帖子
      description: 获取 Reddit 账号发布过的帖子。
      operationId: socq_reddit_user_posts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              additionalProperties: false
              properties:
                callback_url:
                  type: string
                  format: uri
                  description: 可选的任务完成回调 URL。
                results_limit:
                  type: integer
                  minimum: 1
                  maximum: 1000
                  default: 25
                  description: 最多保存的结果数，实际结果可能少于该值。
                sort_by:
                  type: string
                  minLength: 1
                  enum:
                    - hot
                    - new
                    - top
                  default: new
                  description: 结果排序方式。
                username:
                  type: string
                  minLength: 1
                  description: 公开账号用户名。
              required:
                - username
              description: >-
                通过 username 提供一个 Reddit 用户名。sort_by 可选 new（默认，最新）、top（最高分）或
                hot（热门）。results_limit 默认 25，可填 1–1000 之间的整数。每条帖子计 0.5
                积分；likes_count 为帖子分数。
      responses:
        '200':
          description: 任务已受理
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSubmitResponse'
        '422':
          description: Input validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentValidationErrorResponse'
      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: 任务创建时间。
          required:
            - task_id
            - status
    AgentValidationErrorResponse:
      type: object
      properties:
        code:
          type: integer
          const: 422
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            details:
              type: object
          required:
            - message
            - type
      required:
        - code
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: '使用 `Authorization: Bearer <token>` 请求头进行身份验证。'
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: 也可以通过 `x-api-key` 请求头提供 API Key。

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.