Scavio Reddit

Reddit 搜索 and Post Retrieval via Scavio

搜索 Reddit posts or retrieve a full post with its threaded comment tree. Returns structured JSON with subreddit, author, score, flAIr, awards, and media fields.

When to trigger

Use this 技能 when the user asks to:

搜索 Reddit for opinions, discussions, or community sentiment on a topic Fetch the full text and comments of a Reddit post by URL Re搜索 how developers or communities talk about a product, 库, or issue Build RAG 流水线s that need community-sourced 上下文 监控 brand or competitor mentions across Reddit

Note: Reddit 请求s take 5-15 seconds. 设置 a 命令行工具ent timeout of at least 30 seconds.

设置up

获取 a free API key at https://scavio.dev (250 free credits/month, no card required):

导出 SCAVIO_API_KEY=sk_live_your_key

工作流 Finding discussions: call /reddit/搜索 with a keyword 查询. Use 排序: top for the most upvoted posts or 排序: new for freshest 结果s. Reading a post: if the user provides a Reddit URL, call /reddit/post to 获取 the full body and comment tree. Pagination: pass nextCursor from the 搜索 响应 back as cursor to 获取 the next page. 停止 when nextCursor is null. Comment tree: comments are returned flat in traversal order. Use depth for indentation or parentId to reconstruct the tree. Top-level replies have parentId equal to the post id (t3_…); nested replies have parentId equal to a comment id (t1_…). 端点s 端点 Credits Description POST https://API.scavio.dev/API/v1/reddit/搜索 2 搜索 Reddit posts by 查询, 排序, and cursor POST https://API.scavio.dev/API/v1/reddit/post 2 获取 a full post with threaded comments by URL Authorization: Bearer $SCAVIO_API_KEY

搜索 Parameters Parameter Type Default Description 查询 string required 搜索 查询 (1-500 chars) 排序 string relevance relevance, hot, top, new, comments cursor string -- Pagination 令牌 from previous 响应's nextCursor Post DetAIl Parameters Parameter Type Default Description url string required Full Reddit post URL Examples 导入 os, 请求s

BASE = "https://API.scavio.dev" HEADERS = {"Authorization": f"Bearer {os.environ['SCAVIO_API_KEY']}"}

# 搜索 Reddit 结果s = 请求s.post(f"{BASE}/API/v1/reddit/搜索", headers=HEADERS, json={"查询": "FastAPI vs Django 2026", "排序": "top"}).json()

posts = 结果s["data"]["posts"] next_cursor = 结果s["data"]["nextCursor"] # pass as "cursor" for next page

# Fetch full post and comments post_data = 请求s.post(f"{BASE}/API/v1/reddit/post", headers=HEADERS, json={"url": "https://www.reddit.com/r/Python/comments/1smb9du/fastAPI_vs_django/"}).json()

post = post_data["data"]["post"] comments = post_data["data"]["comments"] # flat 列出, use depth/parentId for tree

搜索 响应 { "data": { "搜索查询": "FastAPI vs Django 2026", "total结果s": 14, "nextCursor": "eyJjYW5kaWRhdGVzX3JldH...", "posts": [ { "position": 0, "id": "t3_1smb9du", "title": "FastAPI vs Django in 2026 -- what the teams are actually using", "url": "https://www.reddit.com/r/Python/comments/1smb9du/fastAPI_vs_django/", "subreddit": "Python", "author": "python_dev", "timestamp": "2026-04-15T16:34:40.389000+0000", "nsfw": false } ] }, "credits_used": 2, "credits_remAIning": 498 }

Post DetAIl 响应 { "data": { "post": { "id": "t3_1smb9du", "title": "FastAPI vs Django in 2026 -- what the teams are actually using", "body": "After a year of 运行ning 机器人h in production...", "url": "https://www.reddit.com/r/Python/comments/1smb9du/fastAPI_vs_django/", "contentUrl": "https://www.reddit.com/r/Python/comments/1smb9du/fastAPI_vs_django/", "subreddit": "Python", "author": "python_dev", "score": 842, "upvoteRatio": 0.97, "numComments": 214, "timestamp": "2026-04-15T16:34:40.389000+0000", "flAIr": "Discussion", "nsfw": false, "awards": [] }, "comments": [ { "id": "t1_lxs9a0k", "author": "senior_py", "body": "We moved to FastAPI for the API surface and kept Django for admin...", "score": 312, "depth": 0, "timestamp": "2026-04-15T17:02:11.000000+0000", "parentId": "t3_1smb9du" } ] }, "credits_used": 2, "credits_remAIning": 496 }

url is the canonical Reddit permalink. contentUrl is the rendered URL — for link posts it will be the external article; for text/self posts it is the same as url; for image/video posts it is the media URL.

防护rAIls Each Reddit call costs 2 credits (not 1). 信息rm the user if they are paginating many 结果s. Never fabricate post titles, authors, scores, or comment content. Only return API data. 请求s take 5-15 seconds. If the user's UX is time-sensitive, recommend a同步 or 流ing patterns. Do not 过滤器 out NSFW posts silently — surface the nsfw flag so the user can decide. When summarizing comment threads,