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

> Ask Reddit Answers a question and get the answer with the comments and posts it cites.

# Reddit Answers

Ask Reddit Answers, Reddit's AI search, a question and get back the answer it builds from Reddit discussions. Each task returns one answer: a one-line summary, the full Markdown response, the comments it quotes with links, the posts it draws on with their titles, scores and comment counts, the subreddits Reddit recommends for the topic and the follow-up questions it suggests. Use it to learn what Reddit users recommend, see which threads and communities shape the answer for a product or brand, or feed grounded Reddit opinions into research and AI workflows.

```json theme={"dark"}
{
  "query": "what do people say about standing desks for back pain"
}
```

Provide a question in query, written as you would ask it on Reddit Answers. Returns one answer summarized from Reddit discussions, with the quoted comments, the posts it draws on, recommended subreddits and follow-up questions.

## Standard 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 | Reddit Answers conversation ID. |
| `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 | Link to the answer on Reddit Answers. |
| `published_at` | `string` | Yes | Time the answer was generated, in ISO 8601 format. |
| `collected_at` | `string` | No | Time SocQ collected or processed this result, in ISO 8601 format. |
| `query` | `string` | Yes | Question that was asked. |
| `summary` | `string` | Yes | One-sentence answer that opens the response. |
| `answer` | `string` | Yes | Full answer in Markdown, with headings, bullet points and quoted comments linked to Reddit. |
| `citations` | `array<object>` | Yes | Comments and posts quoted in the answer. |
| `citations.text` | `string` | Yes | Quoted text. |
| `citations.url` | `string` | Yes | Link to the quoted comment or post. |
| `citations.subreddit` | `string` | Yes | Subreddit of the quoted comment or post, without r/. |
| `citations.source_type` | `string` | Yes | Kind of quoted source: `comment` or `post`. |
| `source_posts` | `array<object>` | Yes | Reddit posts the answer draws on. |
| `source_posts.id` | `string` | Yes | Reddit post ID. |
| `source_posts.url` | `string` | Yes | Link to the post. |
| `source_posts.title` | `string` | Yes | Title of the post. |
| `source_posts.text` | `string` | Yes | Body text of the post. |
| `source_posts.subreddit` | `string` | Yes | Subreddit of the post, without r/. |
| `source_posts.author_username` | `string` | Yes | Username of the post author. |
| `source_posts.score` | `integer` | Yes | Score of the post (upvotes minus downvotes). |
| `source_posts.comments_count` | `integer` | Yes | Number of comments on the post. |
| `source_posts.published_at` | `string` | Yes | Time the post was published, in ISO 8601 format. |
| `recommended_subreddits` | `array<object>` | Yes | Subreddits Reddit recommends for the question. |
| `recommended_subreddits.name` | `string` | Yes | Name of the subreddit, without r/. |
| `recommended_subreddits.url` | `string` | Yes | Link to the subreddit. |
| `recommended_subreddits.title` | `string` | Yes | Title of the subreddit. |
| `recommended_subreddits.description` | `string` | Yes | Public description of the subreddit. |
| `recommended_subreddits.members_count` | `integer` | Yes | Number of members of the subreddit. |
| `follow_up_queries` | `array<string>` | Yes | Follow-up questions Reddit suggests after the answer. |

The following example shows the response format for a completed task. Actual data depends on your query.

## Completed Task Response

```json theme={"dark"}
{
  "code": 200,
  "data": {
    "task_id": "example-reddit-answers",
    "status": "succeeded",
    "public_id": "reddit/answers",
    "result_count": 1,
    "credits_amount": 6,
    "results": {
      "limit": 50,
      "next_cursor": null,
      "has_more": false,
      "schema_id": "reddit-answer",
      "schema_version": "1.0",
      "items": [
        {
          "id": "6f3dc9a1-d47b-49b2-a063-28cc8a0f96ce",
          "platform": "reddit",
          "resource": "answers",
          "type": "answer",
          "url": "https://www.reddit.com/answers/6f3dc9a1-d47b-49b2-a063-28cc8a0f96ce/?q=what+do+people+say+about+standing+desks+for+back+pain",
          "published_at": "2026-11-20T08:10:24Z",
          "collected_at": "2026-11-20T08:10:39Z",
          "query": "what do people say about standing desks for back pain",
          "summary": "People on Reddit generally say changing positions helps more than standing alone, though some report real relief and others find prolonged standing uncomfortable.",
          "answer": "People on Reddit generally say **changing positions helps more than standing alone**, though some report real relief and others find prolonged standing uncomfortable.\n\n### What people say helps\n\n> One of the biggest thing that helped me was not doing either for too long.",
          "citations": [
            {
              "text": "Yes, just switch between sitting and standing every 45ish minutes or so. There is a big difference from being sedentary all day.",
              "url": "https://www.reddit.com/r/StandingDesk/comments/1vy645v/comment/p5udbyx/",
              "subreddit": "StandingDesk",
              "source_type": "comment"
            }
          ],
          "source_posts": [
            {
              "id": "12658mg",
              "url": "https://www.reddit.com/r/backpain/comments/12658mg/do_you_recommend_a_standing_desk/",
              "title": "Do you recommend a standing desk?",
              "text": "I got diagnosed with bulging disc at L4/5 and still recovering.",
              "subreddit": "backpain",
              "author_username": "shootingstars00987",
              "score": 18,
              "comments_count": 27,
              "published_at": "2023-03-30T00:00:10Z"
            }
          ],
          "recommended_subreddits": [
            {
              "name": "StandingDesk",
              "url": "https://www.reddit.com/r/StandingDesk/",
              "title": "Standing Desks",
              "description": "StandingDesk stands (heh) against Reddit corporate takeovers",
              "members_count": 68505
            }
          ],
          "follow_up_queries": [
            "standing desk vs walking pad back pain",
            "how often switch between sitting and standing"
          ]
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/reddit/answers
openapi: 3.1.0
info:
  title: SocQ Agent API
  version: v1-c5d5a0c07a78
  description: Asynchronous social data API generated from the SocQ Capability Registry.
servers:
  - url: https://api.socq.ai
security: []
paths:
  /v1/reddit/answers:
    post:
      tags:
        - reddit
      summary: Reddit Answers API
      description: >-
        Ask Reddit Answers a question and get the answer summarized from Reddit
        discussions, with quoted comments, source posts, recommended subreddits
        and follow-up questions.
      operationId: socq_reddit_answers
      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
                query:
                  type: string
                  minLength: 1
                  description: Question to ask Reddit Answers, in any language.
                  maxLength: 500
              required:
                - query
              description: >-
                Provide a question in query, written as you would ask it on
                Reddit Answers. Returns one answer summarized from Reddit
                discussions, with the quoted comments, the posts it draws on,
                recommended subreddits and follow-up questions.
      responses:
        '200':
          description: Task accepted
          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
        data:
          type: object
          properties:
            task_id:
              type: string
            status:
              type: string
            created_time:
              type:
                - string
                - 'null'
          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
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

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