Reddit Search Users API

Endpoint

GET /v1/reddit/users

Parameters

query *

Search keyword (max 500 characters)

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

is_gold

Whether the user has Reddit Premium

is_mod

Whether the user is a moderator

icon_img

URL to profile avatar

created_at

Account creation date

url

Link to the profile

count

Total results returned

Example Request

curl "https://apidirect.io/v1/reddit/users?query=programming" \
  -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"}
)
print(response.json())

Example Response

{
  "users": [
    {
      "username": "spez",
      "user_id": "1w72",
      "description": "CEO of Reddit",
      "link_karma": 148670,
      "comment_karma": 650342,
      "total_karma": 799012,
      "has_verified_email": true,
      "is_gold": true,
      "is_mod": true,
      "icon_img": "https://styles.redditmedia.com/...",
      "created_at": "2005-06-06 04:00:00",
      "url": "https://reddit.com/user/spez"
    }
  ],
  "count": 25
}

Frequently asked questions

What user data is returned?

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

How many users are returned?

Each request returns up to 25 user results.

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 request. 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 3 simultaneous requests per endpoint per user. If you need more, just get in touch.