Reddit User Search API

Search Reddit for user accounts matching a phrase. Each result includes the username, total karma, avatar and profile link.

Endpoint: POST /reddit/search/users
Price: 1 credit per request
SDK: client.reddit.searchUsers()
MCP tool: reddit_search_users

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/reddit/search/users" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "spez"
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/reddit/search/users",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "query": "spez",
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/reddit/search/users", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "query": "spez"
  }),
});
const data = await response.json();

request.ts

import { Bridgly } from "@bridgly/sdk";
const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });
const res = await client.reddit.searchUsers({
  query: "spez"
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the Reddit User Search API return?

Find Reddit accounts by username or keyword. Get usernames, karma, avatars and profile links as JSON through the Reddit User Search API. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

querystringrequired: The text to search Reddit for, e.g. "openai", "best keyboard".
subredditstring: Restrict the search to a single subreddit (name with or without the "r/" prefix). Only applies to post search.
sortenum: Result ordering. Defaults to "relevance".; relevance | hot | top | new | comments
timeenum: Restrict results to a recent window. Defaults to "all".; hour | day | week | month | year | all
cursorstring: The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "nextCursor": "string",
    "users": [
      {
        "id": "string",
        "fullname": "string",
        "username": "string",
        "profileUrl": "string",
        "karma": 0,
        "iconUrl": "string"
      }
    ],
    "query": "string"
  }
}

[ USE CASES ]

What can you build with the Reddit User Search API?

Find an account

Match a name or handle to the right Reddit user.

Discover creators

Find accounts whose names match a brand or topic.

Check for impersonation

See which accounts use your brand name.

[ FAQ ]

Reddit User Search API questions

How do I find a Reddit account by name?

Send the name or a keyword as the query. Each account comes back with its username, karma, avatar and profile link; open one with the Reddit User API for full details.

Can I find the Reddit account of a brand or creator?

Yes. Search the brand or creator name, compare karma, then open the likely matches with the Reddit User API to check account age and verification.

How do I get more than 10 users from a Reddit search?

Each call returns up to 10 users and a nextCursor. Send the same query with it as cursor to get the next page; it is null when there are no more results.

How do I use the Reddit User Search API?

Send a POST request to https://api.bridgly.app/reddit/search/users with query in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.reddit.searchUsers(). AI agents connected to Bridgly over MCP can call the reddit_search_users tool.

How much does the Reddit User Search API cost?

Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

[ MORE ENDPOINTS ]

More Reddit endpoints

The same API key works on every endpoint. See all Reddit API endpoints.

Try the Reddit User Search API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI

free credits

On business email signup. No credit card required.

Start free with 100 credits

Book a demo Read the docs