---
title: "Reddit User Analyzer"
method: GET
path: "/v1/reddit/users/{name}/analysis"
tags: ["reddit"]
---

# Reddit User Analyzer

`GET /v1/reddit/users/{name}/analysis`

## Request

- Base URL: `https://chatterapi.com`
- URL: `https://chatterapi.com/v1/reddit/users/{name}/analysis`
- Auth: HTTP bearer

Analyse a public Reddit account from what Reddit shows right now: account age, karma split, most active subreddits, activity by UTC hour and weekday, average and median score, and the top 3 posts. It reads the profile plus the latest posts and comments (up to 25 of each), so every figure describes that sample, not the account's full history. Removed and deleted content cannot be recovered. Costs 7 credits when all three parts answer (3 for the profile, 2 for posts, 2 for comments); a part that fails is not charged. Tip: check sample.items before you trust the percentages; an account with few public posts gives thin results. Costs up to 7 credits.

## Path parameters

- `name` string, required

## Query parameters

- `nsfw` union
  - boolean
  - string

## Response `200`

Success

- object
  - `data` RedditUserAnalysis, required
    - `username` string, required
    - `createdAt` string, nullable, required: ISO 8601 UTC timestamp
    - `accountAgeDays` number, nullable, required
    - `karma` object, required
      - `total` number, nullable, required
      - `post` number, nullable, required
      - `comment` number, nullable, required
    - `sample` object, required
      - `posts` number, required
      - `comments` number, required
      - `items` number, required
      - `postShare` number, nullable, required
      - `commentShare` number, nullable, required
      - `oldestAt` string, nullable, required: ISO 8601 UTC timestamp
      - `newestAt` string, nullable, required: ISO 8601 UTC timestamp
      - `spanDays` number, nullable, required
      - `adultSkipped` number, required
    - `topSubreddits` object[], required
      - `name` string, required
      - `posts` number, required
      - `comments` number, required
      - `items` number, required
      - `share` number, required
    - `activityByHour` number[], required
    - `activityByWeekday` number[], required
    - `score` object, required
      - `average` number, nullable, required
      - `median` number, nullable, required
      - `scored` number, required
    - `topPosts` object[], required
      - `id` string, required
      - `title` string, required
      - `subreddit` string, required
      - `score` number, nullable, required
      - `numComments` number, nullable, required
      - `createdAt` string, required: ISO 8601 UTC timestamp
      - `url` string, required
  - `credits` Credits, required
    - `charged` integer, required
    - `remaining` integer, required
  - `requestId` string, required
  - `cached` boolean, required
  - `warnings` Warning[]
    - `code` 'partial_data' | 'stale_data' | 'platform_unavailable' | 'source_unavailable', required
    - `platform` 'reddit' | 'x'
    - `source` string
    - `fields` string[]

## Other responses

- `400`: Bad request: invalid_input
- `401`: Unauthorized: missing_key, invalid_key, key_revoked
- `402`: Payment required: insufficient_credits
- `403`: Forbidden: account_suspended, scope_denied
- `404`: Not found: not_found
- `429`: Too many requests: rate_limited
- `500`: Internal error: internal
- `502`: Bad gateway: upstream_error
- `504`: Gateway timeout: upstream_timeout

---

[API](https://skmtc.dev/chatterapi/apis/chatterapi-api.md) · [All operations](https://skmtc.dev/chatterapi/apis/chatterapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatterapi/apis/chatterapi-api/revisions/74036d6f908a?raw)