Reddit Search API

Search Reddit for a phrase and get matching posts, communities and users in one call, sorted by relevance, hot, top, new or comment count and optionally limited to a time window.

Endpoint: POST /reddit/search/all
Price: 1 credit per request
SDK: client.reddit.searchAll()
MCP tool: reddit_search_all

Start free with 100 credits Read docs →

Terminal

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

request.py

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

request.js

const response = await fetch("https://api.bridgly.app/reddit/search/all", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "query": "openai"
  }),
});
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.searchAll({
  query: "openai"
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the Reddit Search API return?

Reddit search API: search Reddit by keyword and get matching posts, communities and users in one call, sorted by relevance, hot, top, new or comments. 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",
    "results": [
      {
        "id": "string",
        "fullname": "string",
        "title": "string",
        "author": "string",
        "authorFullname": "string",
        "score": 0,
        "numComments": 0,
        "createdUtc": 0,
        "createdAt": "string",
        "permalink": "string",
        "postUrl": "string",
        "subreddit": "string",
        "subredditId": "string",
        "subredditPrefixed": "string",
        "subredditUrl": "string",
        "subredditOver18": true,
        "subredditQuarantined": true,
        "thumbnail": "string",
        "over18": true,
        "spoiler": true,
        "snippet": {
          "text": "string",
          "fullname": "string"
        },
        "type": "post"
      }
    ],
    "query": "string"
  }
}

[ USE CASES ]

What can you build with the Reddit Search API?

Explore a topic

See the posts, communities and people behind a keyword at once.

Agent research

Give an AI agent one search that covers all of Reddit.

Find where to engage

Discover both the threads and the subreddits discussing your space.

[ FAQ ]

Reddit Search API questions

Is there an API to search Reddit?

Yes. Send a query and get the posts, communities and users that match, sorted by relevance, hot, top, new or comment count, optionally within a time window. For one kind of result, use the post, community, user or comment search.

How do I find where people discuss a topic on Reddit?

Search the topic and look at both the posts and the communities that come back: the posts are the conversations, the communities are where they happen.

How do I get more than 10 Reddit search results?

Each call returns up to 10 results 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 Search API?

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

How much does the Reddit 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 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