Subreddit-Scoped Data

What is Subreddit-Scoped Data?

You can scope Reddit search to specific subreddits by including the subreddit name in your query (e.g. 'r/Python fastapi' or 'subreddit:Python fastapi'). Each returned post exposes the subreddit name, so you can filter server-side or group by community on the client. Scavio also surfaces the post flair when present, which is often the most reliable signal of post type inside a subreddit (Discussion, Help, Showoff, News). NSFW flags are always returned so you can filter adult communities out of family-safe products without an extra lookup.

Example Response

{
  "data": {
    "searchQuery": "r/Python fastapi",
    "totalResults": 28,
    "posts": [
      {
        "position": 0,
        "id": "t3_1smb9du",
        "title": "FastAPI vs Django in 2026",
        "subreddit": "Python",
        "flair": "Discussion",
        "nsfw": false,
        "author": "python_dev"
      },
      {
        "position": 1,
        "id": "t3_1smc7a2",
        "title": "Show: a FastAPI starter with auth, tests, and Postgres",
        "subreddit": "Python",
        "flair": "Showoff",
        "nsfw": false,
        "author": "mypy_fan"
      }
    ]
  }
}

Use Cases

• Scoping brand monitoring to industry-specific subreddits
• Building niche content feeds for vertical AI assistants
• Filtering by post flair (e.g. Help posts for a support agent)
• Excluding NSFW subreddits from family-safe products
• Benchmarking share-of-voice within a target community

Why Subreddit-Scoped Data Matters

Reddit's community structure is its signal. A brand mention in r/Python from a senior engineer is not the same as the same mention in a drama subreddit. Subreddit-scoped search turns broad queries into focused intelligence without writing a custom crawler per community.

LangChain Example

Drop subreddit-scoped data data into your LangChain agent in a few lines:

from langchain_scavio import ScavioRedditSearch

tool = ScavioRedditSearch()
results = tool.invoke({"query": "r/Python fastapi 2026", "sort": "new"})

help_posts = [p for p in results["data"]["posts"] if (p.get("flair") or "").lower() == "help"]
for post in help_posts:
    print(f"r/{post['subreddit']} -- {post['title']}")