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.
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 }}