Skip to content

Reddit user API

Look up a Reddit user's profile, read their posts and comments, check whether an account is active or suspended, and summarize where they are active. One key, JSON back.

Look up a Reddit user now, no signupThen call the same data from code.

The job

Teams use user data to vet a contributor, find the people who keep asking about a topic, or check an account before they reply to it. The calls cover the profile, the history and a summary of activity.

It is read-only and works on public data. It cannot send messages, follow users or act as them.

How it works

  1. Look up the profile

    Call reddit.user with a username.

  2. Read the history

    Call reddit.user_posts and reddit.user_comments to page through what they have written.

  3. Check the account

    Call reddit.user_status to see whether the account is active, suspended or missing.

  4. Summarize activity

    Call reddit.user_analysis to see which communities a user is active in.

Endpoints that do it

EndpointWhat it's forCredits
Get a userGET /v1/reddit/users/{name}A user's public profile.up to 3 credits
List user postsGET /v1/reddit/users/{name}/postsThe posts a user has made.2 credits
List user commentsGET /v1/reddit/users/{name}/commentsThe comments a user has made.2 credits
Get user statusGET /v1/reddit/users/{name}/statusWhether an account is active, suspended or missing.2 credits
Analyse a userGET /v1/reddit/users/{name}/analysisWhere a user is active.up to 7 credits

Free tools for the same job

Try the job in a browser first. These tools call the same endpoints, and you don't need a key or any code.

Looking up a user

Call the profile endpoint with a username to see karma, account age and status.

curl "https://api.chatterapi.com/v1/reddit/users/spez" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"
response, first 2 rows
{
  "data": {
    "username": "spez",
    "id": "t2_1w72",
    "createdAt": "2005-06-06T04:00:00.000Z",
    "karma": {
      "total": 941002,
      "post": 184509,
      "comment": 756493
    },
    "bio": null,
    "avatarUrl": "https://styles.redditmedia.com/t5_3k30p/styles/profileIcon_uj015iwx9s7g1.png",
    "badges": null
  }
}

Recorded from a live call on . Long text is shortened and the cursor is cut. A live key is charged up to 3 credits for this call. A test key returns this same sample for 0 credits.

What it won't do

  • It is read-only and covers public data only.
  • Suspended and deleted accounts return a status, not their old content.
  • Reddit's content rules apply to what you do with the data.

Questions

Can I check if a Reddit account is suspended?
Yes. The status call returns whether the account is active, suspended or missing. The free account checker does the same in your browser.
Can I get all of a user's posts and comments?
Yes, page by page, as far as the public history goes.
Can I search for users instead of looking one up?
Yes. The user search call finds accounts by keyword. See Reddit user search.

More ways to use the API

Build it with one API key

Try it free for 7 days with 1,000 credits.