> ## 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 User Profile

> Get karma, activity counts and profile details of Reddit accounts.

# Reddit User Profile

Look up Reddit accounts by username and get one row per account: total karma split into post and comment karma, how many posts and comments the account has made, when it was created, its profile description and avatar, trophy count, and flags for verified accounts and Reddit employees. Use it to vet a creator before outreach, judge how established the authors in a thread are, or keep a watchlist of accounts that matter in your niche.

```json theme={"dark"}
{
  "usernames": [
    "spez",
    "GovSchwarzenegger"
  ]
}
```

Provide up to 100 Reddit usernames in usernames, with or without the u/ prefix. Each account returns one row with its karma, activity counts and profile details, and costs 0.5 credits.

## 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 | 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 | Profile URL of the account. |
| `published_at` | `string` | Yes | Time the account was created, in ISO 8601 format. |
| `collected_at` | `string` | No | Time SocQ collected or processed this result, in ISO 8601 format. |
| `username` | `string` | Yes | Reddit username, without the u/ prefix. |
| `name` | `string` | Yes | Display name shown on the profile; the username when none is set. |
| `text` | `string` | Yes | Profile description written by the user. |
| `avatar_url` | `string` | Yes | URL of the account avatar image. |
| `cover_url` | `string` | Yes | URL of the profile banner image. |
| `is_verified` | `boolean` | Yes | Whether Reddit marks the account as verified. |
| `is_employee` | `boolean` | Yes | Whether the account belongs to a Reddit employee. |
| `is_nsfw` | `boolean` | Yes | Whether the profile is marked as adult content. |
| `trophies_count` | `integer` | Yes | Number of trophies shown in the profile's trophy case. |
| `metrics` | `object` | Yes | Karma and activity counts of the account. |
| `metrics.karma_count` | `integer` | Yes | Total karma of the account. |
| `metrics.post_karma_count` | `integer` | Yes | Karma earned from posts. |
| `metrics.comment_karma_count` | `integer` | Yes | Karma earned from comments. |
| `metrics.posts_count` | `integer` | Yes | Number of posts the account has made. |
| `metrics.comments_count` | `integer` | Yes | Number of comments the account has made. |
| `metrics.followers_count` | `integer` | Yes | Number of users following the account. |

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-user-profile",
    "status": "succeeded",
    "public_id": "reddit/user-profile",
    "result_count": 1,
    "credits_amount": 0.5,
    "results": {
      "limit": 50,
      "next_cursor": null,
      "has_more": false,
      "schema_id": "redditor",
      "schema_version": "1.0",
      "items": [
        {
          "id": "t2_1w72",
          "platform": "reddit",
          "resource": "user-profile",
          "type": "profile",
          "url": "https://www.reddit.com/user/spez/",
          "published_at": "2005-06-06T04:00:00Z",
          "collected_at": "2026-11-17T14:40:26.031858Z",
          "username": "spez",
          "name": "spez",
          "text": "Reddit CEO",
          "avatar_url": "https://styles.redditmedia.com/t5_3k30p/styles/profileIcon_uj015iwx9s7g1.png?width=64&height=64&frame=1&auto=webp&crop=64:64,smart&s=0af32bd27feadee648af9434f5d8ffa782225a45",
          "cover_url": null,
          "is_verified": true,
          "is_employee": true,
          "is_nsfw": false,
          "trophies_count": 54,
          "metrics": {
            "karma_count": 941417,
            "post_karma_count": 184793,
            "comment_karma_count": 756624,
            "posts_count": 852,
            "comments_count": 3229,
            "followers_count": 0
          }
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/reddit/user-profile
openapi: 3.1.0
info:
  title: SocQ Agent API
  version: v1-87892a6484c2
  description: Asynchronous social data API generated from the SocQ Capability Registry.
servers:
  - url: https://api.socq.ai
security: []
paths:
  /v1/reddit/user-profile:
    post:
      tags:
        - reddit
      summary: Reddit User Profile API
      description: >-
        Collect the karma, activity counts and profile details of Reddit
        accounts.
      operationId: socq_reddit_user_profile
      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
                usernames:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  minItems: 1
                  description: Reddit usernames, with or without the u/ prefix.
                  maxItems: 100
              required:
                - usernames
              description: >-
                Provide up to 100 Reddit usernames in usernames, with or without
                the u/ prefix. Each account returns one row with its karma, post
                and comment counts, account age and profile details.
      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.