Reddit Search Users API

Endpoint

GET /v1/reddit/users

Parameters

query *

Search keyword (max 500 characters)

pages

Number of pages to fetch, 1-4 (default: 1). Each page returns up to 25 users

Response fields

users

Array of matching user profiles

username

Reddit username

user_id

Reddit user ID

description

Profile bio / description

link_karma

Karma from posts

comment_karma

Karma from comments

total_karma

Combined post and comment karma

has_verified_email

Whether the user has a verified email

verified

Whether the account is verified

is_gold

Whether the user has Reddit Premium

is_mod

Whether the user is a moderator

is_employee

Whether the user is a Reddit employee

nsfw

Whether the profile is marked NSFW

icon_img

URL to profile avatar

banner_img

Profile banner URL, or empty string

created_at

Account creation date

url

Link to the profile

pages

Number of pages returned

count

Total results returned

Example Request

curl "https://apidirect.io/v1/reddit/users?query=programming&pages=2" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/reddit/users",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "programming", "pages": 2}
)
print(response.json())

Example Response

{
  "users": [
    {
      "username": "FrequencyProgramming",
      "user_id": "5btdelnr",
      "description": "Our moto is simply to spread positive energy and thoughts all over the world. Our music generally helps to enhance positive energy and relax the mind/body/so...",
      "link_karma": 563,
      "comment_karma": 167,
      "total_karma": 730,
      "has_verified_email": true,
      "verified": true,
      "is_gold": false,
      "is_mod": false,
      "is_employee": false,
      "nsfw": false,
      "icon_img": "https://styles.redditmedia.com/t5_2bjoel/styles/profileIcon_hrd7fh726c941.jpg?width=256&height=256&crop=256:256,smart&s=87813f382b26c26c6d79f01425814bd54931273e",
      "banner_img": "https://styles.redditmedia.com/t5_2bjoel/styles/profileBanner_s18l62qo6c941.jpg?width=1280&height=384&crop=1280:384,smart&s=aaffe2423335ba6ced9b97b696ad39c0afe628f9",
      "created_at": "2019-12-29 19:24:22",
      "url": "https://reddit.com/user/FrequencyProgramming"
    }
  ],
  "pages": 2,
  "count": 32
}

Frequently asked questions

What user data is returned?

Each result includes username, user ID, bio, post karma, comment karma, total karma, email verification and verified status, Reddit Premium, moderator and employee status, NSFW flag, profile avatar and banner, account creation date, and profile URL.

How many users are returned?

25 per page, up to 4 pages (about 100 users) per search. You're billed for the pages returned.

How is this different from the Reddit Posts endpoint?

The Search Users endpoint finds Reddit user profiles by keyword, while the Posts endpoint searches post content. Use Search Users for finding specific users or communities of users related to a topic.

How does pricing work?

You only pay for successful requests. The Reddit Search Users API costs $0.003 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 10 simultaneous requests per endpoint per user. If you need more, just get in touch.