API referenceReddit
Reddit search (v2)
Keyword search across Reddit or inside one subreddit, with paging.
Searches Reddit and returns deduplicated posts. Reddit's own search
operators work, so author:spez and flair:"Discussion" behave as they
do on the site.
Results are deduplicated across the pages fetched in a single call, so
total_posts counts unique posts rather than rows retrieved.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 4.2s.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/reddit-search-v2" \ -H "Content-Type: application/json" \ -d '{ "query": "tesla cybertruck", "sort": "top", "time_filter": "week" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "has_more": true, "next_cursor": "t3_1vul91m", "pages_fetched": 1, "posts": [ { "archived": false, "author": { "flair": null, "id": "t2_nsl36", "is_blocked": false, "is_submitter": null, "name": "ScoobiesSnacks", "patreon_flair": false, "premium": false }, "awards": [], "body_type": "link", "comments": null, "comments_fetched": null, "contest_mode": false, "created_iso": "2026-08-20T01:45:42Z", "created_utc": 1787190342, "crosspost_parent": null, "crosspost_parent_post": null, "distinguished": null, "domain": "bloomberg.com", "downvotes": 0, "edited": null, "edited_iso": null, "flair": { "background_color": "#edeff1", "css_class": "", "richtext": [ { "emoji": null, "text": "📰 News", "type": "text", "url": null } ], "template_id": "b8b15e54-0367-11ef-9b65-86578d016ea6", "text": "📰 News", "text_color": "dark", "type": "richtext" }, "gallery": [], "hidden": false, "hide_score": false, "id": "t3_1vt5wrf", "id_short": "1vt5wrf", "is_gallery": false, "is_original_content": false, "is_self": false, "is_video": false, "kind": "post", "locked": false, "media": null, "more_comment_ids": [], "num_comments": 184, "num_crossposts": 0, "num_duplicates": null, "over_18": false, "permalink": "https://www.reddit.com/r/electriccars/comments/1vt5wrf/teslas_cratering_cybertruck_sales_evoke_ford/", "pinned": false, "poll": null, "post_hint": "link", "preview_images": [ { "id": "agqBXY6Zws6klAjqtmOznl546GpssW5Qdf779OCFOCI", "resolutions": [ { "height": 72, "url": "https://external-preview.redd.it/agqBXY6Zws6klAjqtmOznl546GpssW5Qdf779OCFOCI.jpeg?width=108&crop=smart&auto=webp&s=0b12eb2be511a8c339276820e772c9a792aed627", "width": 108 }, { "height": 144, "url": "https://external-preview.redd.it/agqBXY6Zws6klAjqtmOznl546GpssW5Qdf779OCFOCI.jpeg?width=216&crop=smart&auto=webp&s=e6c9fedeec37aacdeb6032b993d09298a8e6b3dc", "width": 216 }, "… 4 more items in the full response" ], "source": { "height": 800, "url": "https://external-preview.redd.it/agqBXY6Zws6klAjqtmOznl546GpssW5Qdf779OCFOCI.jpeg?auto=webp&s=2ba8d5aaa92eeba4397a62dcb7929b2bbf2caa99", "width": 1200 } } ], "quarantine": false, "raw": null, "removal_reason": null, "removed_by_category": null, "score": 294, "selftext": null, "selftext_html": null, "spoiler": false, "stickied": false, "subreddit": { "id": "t5_2tb80", "name": "electriccars", "name_prefixed": "r/electriccars", "subscribers": 37865, "type": "public" }, "suggested_sort": "top", "thumbnail": null, "title": "Tesla’s Cratering Cybertruck Sales Evoke Ford Edsel Comparisons", "total_awards_received": 0, "upvote_ratio": 0.85, "upvotes": 294, "url": "https://www.bloomberg.com/news/features/2026-07-22/tesla-cybertruck-risks-becoming-the-ford-edsel-of-the-ev-era?accessToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzb3VyY2UiOiJTdWJzY3JpYmVyR2lmdGVkQXJ0aWNsZSIsImlhdCI6MTc4NDcyNTU4NSwiZXhwIjoxNzg1MzMwMzg1LCJhcnRpY2xlSWQiOiJUSUtLRE1SMjRVOTMwMCIsImJjb25uZWN0SWQiOiJCRUQ0NkJ… (+81 chars)", "view_count": null }, { "archived": false, "author": { "flair": null, "id": "t2_1y4sxqx7ag", "is_blocked": false, "is_submitter": null, "name": "InterstellarKinetics", "patreon_flair": false, "premium": false }, "awards": [], "body_type": "link", "comments": null, "comments_fetched": null, "contest_mode": false, "created_iso": "2026-08-18T23:09:46Z", "created_utc": 1787094586, "crosspost_parent": null, "crosspost_parent_post": null, "distinguished": null, "domain": "futurism.com", "downvotes": 0, "edited": null, "edited_iso": null, "flair": { "background_color": "#00ff48", "css_class": "", "richtext": [], "template_id": "201534f4-fba4-11f0-a603-e2e7c0e6d841", "text": "ARTIFICIAL INTELLIEGENCE", "text_color": "dark", "type": "text" }, "gallery": [], "hidden": false, "hide_score": false, "id": "t3_1vs54tl", "id_short": "1vs54tl", "is_gallery": false, "is_original_content": false, "is_self": false, "is_video": false, "kind": "post", "locked": false, "media": null, "more_comment_ids": [], "num_comments": 12, "num_crossposts": 0, "num_duplicates": null, "over_18": false, "permalink": "https://www.reddit.com/r/InterstellarKinetics/comments/1vs54tl/exclusive_electrek_editorinchief_fred_lambert/", "pinned": false, "poll": null, "post_hint": "link", "preview_images": [ { "id": "Jknpgtd6aj8ckwxYdOB_B3HnIYrrscHwzq8_AoYWkRw", "resolutions": [ { "height": 71, "url": "https://external-preview.redd.it/Jknpgtd6aj8ckwxYdOB_B3HnIYrrscHwzq8_AoYWkRw.jpeg?width=108&crop=smart&auto=webp&s=2cf085ac9038a59be9553427f80770b662306ef8", "width": 108 }, { "height": 143, "url": "https://external-preview.redd.it/Jknpgtd6aj8ckwxYdOB_B3HnIYrrscHwzq8_AoYWkRw.jpeg?width=216&crop=smart&auto=webp&s=3cb0b2ac8ac8b554f8baaec07770322c7bcc67c9", "width": 216 }, "… 4 more items in the full response" ], "source": { "height": 799, "url": "https://external-preview.redd.it/Jknpgtd6aj8ckwxYdOB_B3HnIYrrscHwzq8_AoYWkRw.jpeg?auto=webp&s=4ed76e384c80642981c4574fc5cb346a3f4261e8", "width": 1200 } } ], "quarantine": false, "raw": null, "removal_reason": null, "removed_by_category": null, "score": 86, "selftext": "Fred Lambert, editor-in-chief of the electric vehicle blog Electrek, says his Tesla running the latest Full Self-Driving software nearly drove his car off the highway and into a ditch during a Sunday drive on Quebec’s Autoroute 55 in the Mauricie region. Lambert was cruising at roughly 68 mph in the right lane under cl… (+2698 chars)", "selftext_html": "<!-- SC_OFF --><div class=\"md\"><p>Fred Lambert, editor-in-chief of the electric vehicle blog Electrek, says his Tesla running the latest Full Self-Driving software nearly drove his car off the highway and into a ditch during a Sunday drive on Quebec’s Autoroute 55 in the Mauricie region. Lambert was cruising at roughly… (+2771 chars)", "spoiler": false, "stickied": false, "subreddit": { "id": "t5_fgw1tz", "name": "InterstellarKinetics", "name_prefixed": "r/InterstellarKinetics", "subscribers": 41324, "type": "public" }, "suggested_sort": null, "thumbnail": "https://external-preview.redd.it/Jknpgtd6aj8ckwxYdOB_B3HnIYrrscHwzq8_AoYWkRw.jpeg?width=140&height=93&auto=webp&s=b8724f9b7274e575c9c988d8250d2b399dbce603", "title": "EXCLUSIVE: Electrek Editor-In-Chief, Fred Lambert, Says His Tesla FSD v14.3.6 Suddenly Veered Toward The Highway Exit At 68 MPH, Nearly Sending Him Into A Ditch On A Road He Calls “Perfect Conditions” For Self-Driving ⚠️💥", "total_awards_received": 0, "upvote_ratio": 0.95, "upvotes": 86, "url": "https://futurism.com/future-society/journalist-tesla-fsd-serve-highway", "view_count": null }, "… 23 more items in the full response" ], "query": "tesla cybertruck", "sort": "top", "success": true, "time_filter": "week", "total_posts": 25 }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "reddit-search-v2", "billable": true, "duration_ms": 3115 }}