Reddit Post Search API

Search Reddit posts by phrase, across all of Reddit or within one subreddit, sorted by relevance, hot, top, new or comment count. Each result includes the title, author, subreddit, score, comment count and, when Reddit shows one, a passage matching the query.

Endpoint: POST /reddit/search/posts
Price: 1 credit per request
SDK: client.reddit.searchPosts()
MCP tool: reddit_search_posts

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/reddit/search/posts" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "best CRM for startups",
  "sort": "top",
  "time": "month"
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/reddit/search/posts",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "query": "best CRM for startups",
        "sort": "top",
        "time": "month",
    },
)
data = response.json()

request.js

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

[ REQUEST AND RESPONSE ]

What does the Reddit Post Search API return?

Find Reddit posts across the site or in one subreddit. Filter by time and sort by relevance, top, new or comments with the Reddit Post 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",
    "posts": [
      {
        "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"
        }
      }
    ],
    "query": "string"
  }
}

[ USE CASES ]

What can you build with the Reddit Post Search API?

Brand monitoring

Find every post that mentions your product or a competitor.

Market research

Collect real opinions on a product category from the last month.

Find leads

Spot posts asking for a recommendation in your category.

[ FAQ ]

Reddit Post Search API questions

How do I monitor Reddit for mentions of my brand?

Search your brand name with sort set to new and time set to day, and run it on a schedule. Each post has the title, author, subreddit, score and comment count, plus a passage matching your query when Reddit shows one.

Can I search within one subreddit?

Yes. Set subreddit to its name, for example startups, and only posts in that community are searched.

How do I find what people recommend on Reddit?

Search the question people ask, such as best CRM for startups, sorted by top over the past year. Then read each thread with the Reddit Post API; most recommendations are in the comments.

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

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

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

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