{"uid":"cap_6i04pvXGP64JAn2rpKdLY","slug":"reddit-search-by-keyword-4383fc67","name":"Reddit Search by Keyword","description":"Search Reddit posts by keyword, optionally within a subreddit, sorted by relevance, new or top over a timeframe. Returns title, subreddit, permalink, score, comment count, timestamp and post text — useful for sentiment, community feedback and trend research.","url":"https://agentbit.app/v1/social/reddit/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"type":"string"},"limit":{"type":"integer"},"query":{"type":"string"},"subreddit":{"type":"string"},"timeframe":{"type":"string"}}},"responseSchema":{"type":"json","example":{"results":[{"url":"https://www.reddit.com/r/laravel/comments/abc123/","score":412,"title":"Laravel 13 released — what changed","selftext":"Highlights from the release…","subreddit":"laravel","created_utc":1770000000,"num_comments":87}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tAxOeb-dulq0B_2bUP8zf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Reddit posts by keyword (optionally within a subreddit), returning title, subreddit, permalink, score, comment count, timestamp and post text sorted by relevance, new, or top.","exampleAgentPrompt":"Search Reddit for posts mentioning 'electric vehicles' in r/technology, sorted by top over the past month, and return up to 20 results — I want to see what the community is saying.","exampleUseCases":[{"title":"Brand sentiment research on Reddit","prompt":"Search Reddit for posts mentioning 'Notion' across all subreddits, sorted by relevance, and give me the top 15 results so I can understand what users think about the product."},{"title":"Niche subreddit trend monitoring","prompt":"Find the 10 newest posts in r/investing that mention 'interest rates' — I want to see what people are currently discussing."},{"title":"Competitor feedback analysis","prompt":"Search r/personalfinance for posts about 'Robinhood', sorted by top over the past week, and pull up to 20 results so I can analyze community complaints and praise."}],"resultDescription":"Returns a list of Reddit posts matching the query, each containing the post title, subreddit, permalink URL, upvote score, comment count, creation timestamp, and full post text body. Results are sorted by the requested sort method (relevance, new, or top) and filtered to the specified timeframe and subreddit if provided.","failureModes":["Empty results if the query matches no posts or the subreddit is very small","Invalid subreddit name returns error or empty set","Overly broad query returns noisy, low-quality results","Reddit rate limiting or API unavailability causes upstream failure","Timeframe parameter ignored or misinterpreted if not in expected enum format"],"whenToPreferThis":"Use this endpoint when you need to search Reddit specifically for community sentiment, user feedback, trend signals, or discussions around a keyword — especially when you want structured metadata (score, comment count, timestamp) alongside post text. Prefer this over generic web search when Reddit-community opinion is the target signal, and prefer it over scraping Reddit directly when you need clean, structured output with sorting and subreddit filtering built in.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:45:54.223Z","isFirstParty":false}