Reddit Keyword Scraper

Search Reddit by keyword (sitewide or inside one subreddit) and get matching posts back as structured JSON or CSV, ready for monitoring, lead research, or trend tracking.

What you're collecting

Sometimes you don't want a whole subreddit; you want every post mentioning a specific term: a product name, a competitor, a symptom, a technology. That's a search problem, not a listing problem, and it needs to be scriptable rather than a manual search-and-copy loop.

How UGC Scraper handles it

POST /v1/search takes a query and an optional subreddit to scope it to, plus the same sort (new/top) and limit options as the subreddit endpoint.

cURL

curl -X POST https://api.ugcscraper.com/v1/search \
  -H "Authorization: Bearer rps_live_your_key" -H "Content-Type: application/json" \
  -d '{"query":"reddit api","subreddit":"webscraping","limit":25}'

Python

import requests

r = requests.post(
    "https://api.ugcscraper.com/v1/search",
    headers={"Authorization": "Bearer rps_live_your_key"},
    json={"query": "reddit api", "subreddit": "webscraping", "limit": 25},
)
results = r.json()
for post in results["items"]:
    print(post["title"], post["permalink"])

Node.js

const res = await fetch("https://api.ugcscraper.com/v1/search", {
  method: "POST",
  headers: {
    Authorization: "Bearer rps_live_your_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "reddit api", subreddit: "webscraping", limit: 25 }),
});
const results = await res.json();
for (const post of results.items) {
  console.log(post.title, post.permalink);
}

Output structure

Same shape as a subreddit listing (post summaries, not full comment threads):

{
  "kind": "search",
  "target": "reddit api",
  "count": 25,
  "items": [
    { "id": "abc123", "title": "string", "author": "string", "subreddit": "webscraping",
      "score": 84, "num_comments": 12, "permalink": "https://www.reddit.com/..." }
  ]
}

Practical use cases

  • Growth & lead research: a programmatic alternative to a manual tool like GummySearch: search by keyword, pipe the results into your own tagging and scoring logic, at whatever scale you need.
  • Brand or product monitoring: track every post mentioning your product or a competitor's.
  • Market research: see what people ask about a topic across every subreddit that discusses it, not just one community.

Limitations

Search returns post summaries, not full comment threads; scrape an individual post's permalink for its comments. Results reflect Reddit's own search matching behavior; there's no separate relevance-scoring model layered on top.

Reddit keyword scraper FAQ

Can I search within one specific subreddit?

Yes. Pass a subreddit alongside your query to scope the search, or omit it to search across Reddit.

How is this different from a subreddit scrape?

A subreddit scrape returns recent posts from one community regardless of topic. A keyword search returns posts matching a specific term or phrase, optionally within one subreddit or across all of Reddit.

Can I use this for brand or competitor monitoring?

Yes. Search by your brand, product, or competitor name and pipe the structured results into your own tagging or alerting logic. It's a programmatic alternative to a manual research tool like GummySearch.

Are search results ranked by relevance or recency?

Results sort by new or top, the same sort options as the subreddit endpoint; there's no separate relevance-ranking mode.

Related guides

Start searching Reddit

Free tier, no credit card, live in about two minutes.

Get your API key