# Reddit API: Get user

> Gets a public Reddit user's profile (post and comment karma, account creation date) and their recent posts and comments, newest first. Suspended or nonexistent users are reported as not found.

Unofficial. Not affiliated with or endorsed by Reddit.

- Page: https://fous.com/methods/reddit.com/get-user
- Method: `reddit.com/get_user`, version 1
- Website: reddit.com
- Returns: username, user id, created date, post/comment/total karma, avatar, profile link, recent posts and comments
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `username` | string | yes | `"u/spez"` | Reddit username, u/name, or profile link, for example spez or https://www.reddit.com/user/spez/. |
| `max_results` | integer | no | `100` | Maximum recent posts and comments to return, for example 25. Default 25, maximum 100. Default 25. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "username": "u/spez",
  "max_results": 100
}
```

Its output:

```json
{
  "user_id": "1w72",
  "username": "spez",
  "post_karma": 184487,
  "total_karma": 940980,
  "created_date": "2005-06-06",
  "profile_link": "https://www.reddit.com/user/spez/",
  "comment_karma": 756493,
  "recent_activity": [
    {
      "link": "https://www.reddit.com/r/u_spez/comments/1vgbkge/modernizing_reddits_infrastructure_with_you/p1wosm9/",
      "text": "That was the thinking. Otherwise it would be easier to just replicate the UI. ",
      "type": "comment",
      "score": 11,
      "community": "u_spez",
      "posted_at": "2026-08-05T18:31:50+00:00"
    },
    {
      "link": "https://www.reddit.com/r/u_spez/comments/1vgbkge/modernizing_reddits_infrastructure_with_you/p1w9sot/",
      "text": "If we replace every line of code but the output is the same, is it still old Reddit?",
      "type": "comment",
      "score": 21,
      "community": "u_spez",
      "posted_at": "2026-08-05T17:30:18+00:00"
    },
    {
      "link": "https://www.reddit.com/r/u_spez/comments/1vgbkge/modernizing_reddits_infrastructure_with_you/p1w9j2v/",
      "text": "Karma and Age gates are really blunt tools that, while we understand why they are used today, end up with a blast radius making the it hard for (good) new users finding a way to participate. That makes a bad experience. Our plan is to build tools so you no longer feel the need to rely on hammers lik…",
      "type": "comment",
      "score": 23,
      "community": "u_spez",
      "posted_at": "2026-08-05T17:29:13+00:00"
    }
  ],
  "avatar_image_link": "https://styles.redditmedia.com/t5_3k30p/styles/profileIcon_uj015iwx9s7g1.png?width=256&height=256&crop=256:256,smart&s=aa819b0964f6e3019e769d1cc8ede7318c3869a3"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"reddit.com/get_user","input":{"username":"u/spez","max_results":100}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- How much karma does u/GallowBoob have and when was the account created?
- Pull up the last 50 posts and comments from https://www.reddit.com/user/shittymorph/
- Is the Reddit account throwaway_dev_9182 still active or has it been suspended?
- Check out the profile of user AwkwardTheTurtle on reddit — I want their comment karma vs post karma and their 10 most recent comments
- Show me what poem_for_your_sprog has been posting lately, plus their account age

## Input schema

```json
{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "minLength": 1,
      "description": "Reddit username, u/name, or profile link, for example spez or https://www.reddit.com/user/spez/."
    },
    "max_results": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum recent posts and comments to return, for example 25. Default 25, maximum 100."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "username",
    "created_date",
    "post_karma",
    "comment_karma",
    "total_karma",
    "avatar_image_link",
    "profile_link",
    "recent_activity"
  ],
  "properties": {
    "user_id": {
      "type": "string"
    },
    "username": {
      "type": "string"
    },
    "post_karma": {
      "type": "integer"
    },
    "total_karma": {
      "type": "integer"
    },
    "created_date": {
      "type": "string",
      "format": "date"
    },
    "profile_link": {
      "type": "string"
    },
    "comment_karma": {
      "type": "integer"
    },
    "recent_activity": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "community",
          "text",
          "score",
          "posted_at",
          "link"
        ],
        "properties": {
          "link": {
            "type": "string"
          },
          "text": {
            "type": "string",
            "description": "Post title or the first 500 characters of a comment."
          },
          "type": {
            "enum": [
              "post",
              "comment"
            ],
            "type": "string"
          },
          "score": {
            "type": "integer"
          },
          "community": {
            "type": "string"
          },
          "posted_at": {
            "type": "string",
            "description": "ISO 8601 date and time in UTC."
          }
        },
        "additionalProperties": false
      }
    },
    "avatar_image_link": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": false
}
```

## See more

- [Reddit API: Search posts](https://fous.com/methods/reddit.com/search-posts.md): Finds public Reddit posts by topic, optionally in one community, for a time window and sort order. Returns up to 100 posts in Reddit search order with score, comment count, text and link.
- [Bluesky API: List recent posts](https://fous.com/methods/bsky.app/list-recent-posts.md): Lists an account's latest public Bluesky posts, newest first. Replies and reposts are left out unless requested; a repost's time is when the account reposted it.
- [Threads API: List recent posts](https://fous.com/methods/threads.com/list-recent-posts.md): Lists an account's latest public Threads posts, newest first, with text, engagement counts, thumbnails and links. Only posts shown without logging in are returned.
- [Instagram API: List recent posts](https://fous.com/methods/instagram.com/list-recent-posts.md): Lists the latest publicly embeddable posts and reels from an Instagram account, newest first. Without login Instagram may show fewer posts than requested. View counts that are not available are null.
- [Mastodon API: List recent posts](https://fous.com/methods/mastodon.social/list-recent-posts.md): Lists a Mastodon account's latest public posts, newest first. Replies and boosts are optional. Private and unlisted posts are left out.
- [Medium API: List a writer's or publication's latest articles](https://fous.com/methods/medium.com/list-author-articles.md): Lists the latest public articles by a Medium writer or publication (by username, publication name or Medium link), with dates, reading times, claps, member-only labels and tags.
- [Instagram API: Get profile](https://fous.com/methods/instagram.com/get-profile.md): Gets an Instagram account's public profile from its username, @name or profile link: name, bio, exact follower, following and post counts, verified and private flags, first bio link, profile picture and account ID.
- [X API: Get profile](https://fous.com/methods/x.com/get-profile.md): Gets the public X profile for a username or profile link, including counts, verification, images and account details. Does not include posts or a timeline.
- [All Reddit methods](https://fous.com/methods/reddit.com.md)
