> ## Documentation Index > Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt > Use this file to discover all available pages before exploring further. # Search > Search Reddit for posts 💳 **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/reddit/search openapi: 3.1.0 info: title: SociaVault API version: 1.0.0 description: >- # SociaVault API Documentation The SociaVault API provides comprehensive access to social media data extraction across multiple platforms. ## Features - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter, Reddit, Threads, and more - **Credit-Based System**: Pay-as-you-go pricing with transparent credit costs - **High Performance**: Fast, reliable data extraction - **Comprehensive Data**: Detailed user profiles, videos, posts, comments, and analytics ## Authentication All API requests require authentication using an API key in the `X-API-Key` header: ```bash X-API-Key: sk_live_your_api_key_here ``` Get your API key from the [SociaVault Dashboard](https://sociavault.com/dashboard). ## Credits Each endpoint consumes credits based on data complexity: - Simple requests (profiles): 1 credit - Complex requests (demographics): 20+ credits - Paginated requests: Credits per page Check your credit balance in the dashboard or via the API. ## Support - **Documentation**: https://docs.sociavault.com - **Email**: support@sociavault.com - **Discord**: https://discord.gg/sociavault contact: name: SociaVault Support email: support@sociavault.com url: https://sociavault.com/support license: name: Commercial url: https://sociavault.com/terms servers: - url: https://api.sociavault.com description: Production API security: - ApiKeyAuth: [] tags: - name: account description: Account management and credit balance externalDocs: description: Learn more url: https://docs.sociavault.com/account - name: tiktok description: Scrape TikTok profiles, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok - name: tiktok-shop description: Everything about TikTok Shop externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok-shop - name: instagram description: Gets Instagram profiles, posts, and reels externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/instagram - name: youtube description: Scrape YouTube channels, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/youtube - name: linkedin description: Scrape LinkedIn externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedin - name: facebook description: Get public Facebook profiles and posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebook - name: facebookAdLibrary description: Scrapes the Facebook (Meta) Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookAdLibrary - name: facebookMarketplace description: Search Facebook Marketplace and pull full listing details externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookMarketplace - name: googleAdLibrary description: >- Scrape the Google Ad Transparency Library. *This only gets the public ads. Some ads you need to log in for and sadly we can't get those. Also, since there are so many variations, the return types might not all be 100% the same. externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/googleAdLibrary - name: linkedinAdLibrary description: Search the LinkedIn Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedinAdLibrary - name: twitter description: Get Twitter profiles, tweets, followers and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/twitter - name: reddit description: Scrape Reddit posts and comments externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/reddit - name: threads description: Get Threads posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/threads - name: google description: Scrape Google search results externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/google paths: /v1/scrape/reddit/search: get: tags: - reddit summary: Search description: Search Reddit for posts operationId: reddit_Search parameters: - name: query in: query description: Search query required: true schema: type: string - name: sort in: query description: Sort by required: false schema: type: string enum: - relevance - new - top - comment_count example: relevance - name: timeframe in: query description: Timeframe required: false schema: type: string enum: - all - day - week - month - year example: all - name: after in: query description: Used to paginate to next page required: false schema: type: string example: t3_1i8z28z - name: trim in: query description: Set to true for a trimmed down version of the response required: false schema: type: boolean example: false responses: '200': description: >- Successful response **Key Response Fields:** - `data.posts[n].id`: Short Reddit post ID - `data.posts[n].title`: Post title text - `data.posts[n].author`: Reddit username of the poster - `data.posts[n].subreddit`: Name of the subreddit where the post appears - `data.posts[n].score`: Net upvote score - `data.posts[n].upvote_ratio`: Ratio of upvotes to total votes (0–1) - `data.posts[n].num_comments`: Comment count - `data.posts[n].url`: Full URL to the post - `data.posts[n].is_video`: Whether the post contains native Reddit video - `data.after`: Pagination token — pass as `after` param for the next page content: application/json: examples: full: summary: Full Response value: success: true data: success: true posts: '0': approved_at_utc: null subreddit: oddlysatisfying selftext: '' author_fullname: t2_1ylfum5t saved: false mod_reason_title: null gilded: 0 clicked: false title: Some super clean football! link_flair_richtext: {} subreddit_name_prefixed: r/oddlysatisfying hidden: false pwls: 6 link_flair_css_class: null downs: 0 thumbnail_height: 140 top_awarded_type: null hide_score: false name: t3_1ps03s7 quarantine: false link_flair_text_color: dark upvote_ratio: 0.97 author_flair_background_color: null subreddit_type: public ups: 15906 total_awards_received: 0 media_embed: {} thumbnail_width: 140 author_flair_template_id: null is_original_content: false user_reports: {} secure_media: reddit_video: bitrate_kbps: 1200 fallback_url: >- https://v.redd.it/bvpbu93m7i8g1/CMAF_480.mp4?source=fallback has_audio: true height: 600 width: 480 scrubber_media_url: https://v.redd.it/bvpbu93m7i8g1/CMAF_96.mp4 dash_url: >- https://v.redd.it/bvpbu93m7i8g1/DASHPlaylist.mpd?a=1773194318%2COGI4NzUyMGQ4N2I4MzNmM2Y4ZjI4ZDZkYzk0MTA1NTExY2VlMTkwZTJiZDVlNzBhZjM1MWQ2ZTI1ZTBiM2NlYw%3D%3D&v=1&f=sd duration: 17 hls_url: >- https://v.redd.it/bvpbu93m7i8g1/HLSPlaylist.m3u8?a=1773194318%2CM2Y2NjdmYWUzMDc0NTYxNmFiNDNjNTU0Y2VhMDIzMDRkNzRkZTRmMWEzODVlZDk4MTExNWFlODVkYzdkYjZlMg%3D%3D&v=1&f=sd is_gif: false transcoding_status: completed is_reddit_media_domain: true is_meta: false category: null secure_media_embed: {} link_flair_text: null can_mod_post: false score: 15906 approved_by: null is_created_from_ads_ui: false author_premium: false thumbnail: >- https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?width=140&height=140&crop=1:1,smart&format=jpg&auto=webp&s=3932cc3a7c6b47a49fbcbc29b4df5b27efa8b906 edited: false author_flair_css_class: null author_flair_richtext: {} gildings: {} post_hint: hosted:video content_categories: null is_self: false mod_note: null created: 1766299621 link_flair_type: text wls: 6 removed_by_category: null banned_by: null author_flair_type: text domain: v.redd.it allow_live_comments: false selftext_html: null likes: null suggested_sort: null banned_at_utc: null url_overridden_by_dest: https://v.redd.it/bvpbu93m7i8g1 view_count: null archived: false no_follow: false is_crosspostable: false pinned: false over_18: false preview: images: '0': source: url: >- https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?format=pjpg&auto=webp&s=56a3425b2e47c6b51a41e05be929ffc8591726e8 width: 1440 height: 1800 resolutions: '0': url: >- https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?width=108&crop=smart&format=pjpg&auto=webp&s=0490b5b161abd1153dd7ab7570fda758a393219f width: 108 height: 135 '1': url: >- https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?width=216&crop=smart&format=pjpg&auto=webp&s=cd250ce37a5be797841061d7fcbafa697cdd31f3 width: 216 height: 270 '2': url: >- https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?width=320&crop=smart&format=pjpg&auto=webp&s=213bed307e4781a00aa14f8113e5396e2eea85e6 width: 320 height: 400 '3': url: >- https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?width=640&crop=smart&format=pjpg&auto=webp&s=eee57393351802bac50f28d55546f894d7684669 width: 640 height: 800 '4': url: >- https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?width=960&crop=smart&format=pjpg&auto=webp&s=553205d24aa893992866dae9eeb7741d75ed77de width: 960 height: 1200 '5': url: >- https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?width=1080&crop=smart&format=pjpg&auto=webp&s=0e1bc476d16291595cc92cf2c2addc6c2ff0ce5b width: 1080 height: 1350 variants: {} id: >- ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E enabled: false all_awardings: {} awarders: {} media_only: false can_gild: false spoiler: false locked: false author_flair_text: null treatment_tags: {} visited: false removed_by: null num_reports: null distinguished: null subreddit_id: t5_2x93b author_is_blocked: false mod_reason_by: null removal_reason: null link_flair_background_color: '' id: 1ps03s7 is_robot_indexable: true report_reasons: null author: HassanMoRiT discussion_type: null num_comments: 226 send_replies: true contest_mode: false mod_reports: {} author_patreon_flair: false author_flair_text_color: null permalink: >- /r/oddlysatisfying/comments/1ps03s7/some_super_clean_football/ stickied: false url: >- https://www.reddit.com/r/oddlysatisfying/comments/1ps03s7/some_super_clean_football/ subreddit_subscribers: 12384607 created_utc: 1766299621 num_crossposts: 0 media: reddit_video: bitrate_kbps: 1200 fallback_url: >- https://v.redd.it/bvpbu93m7i8g1/CMAF_480.mp4?source=fallback has_audio: true height: 600 width: 480 scrubber_media_url: https://v.redd.it/bvpbu93m7i8g1/CMAF_96.mp4 dash_url: >- https://v.redd.it/bvpbu93m7i8g1/DASHPlaylist.mpd?a=1773194318%2COGI4NzUyMGQ4N2I4MzNmM2Y4ZjI4ZDZkYzk0MTA1NTExY2VlMTkwZTJiZDVlNzBhZjM1MWQ2ZTI1ZTBiM2NlYw%3D%3D&v=1&f=sd duration: 17 hls_url: >- https://v.redd.it/bvpbu93m7i8g1/HLSPlaylist.m3u8?a=1773194318%2CM2Y2NjdmYWUzMDc0NTYxNmFiNDNjNTU0Y2VhMDIzMDRkNzRkZTRmMWEzODVlZDk4MTExNWFlODVkYzdkYjZlMg%3D%3D&v=1&f=sd is_gif: false transcoding_status: completed is_video: true created_at_iso: '2025-12-21T06:47:01.000Z' after: t3_1qcqb77 creditsUsed: 1 trimmed: summary: Trimmed Response value: success: true data: success: true posts: '0': id: 1ps03s7 author: HassanMoRiT author_fullname: t2_1ylfum5t subreddit: oddlysatisfying title: Some super clean football! downs: 0 name: t3_1ps03s7 upvote_ratio: 0.97 ups: 15905 total_awards_received: 0 score: 15905 created: 1766299621 num_comments: 226 url: >- https://www.reddit.com/r/oddlysatisfying/comments/1ps03s7/some_super_clean_football/ subreddit_subscribers: 12384607 is_video: true created_utc: 1766299621 after: t3_1qcqb77 creditsUsed: 1 '400': description: Bad Request - Invalid parameters or missing required fields content: application/json: schema: type: object properties: error: type: string example: 'Missing required parameter: handle' endpoint: type: string credits_required: type: integer required: - error '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: type: object properties: error: type: string example: Invalid API key docs: type: string example: https://docs.sociavault.com/authentication required: - error '402': description: Payment Required - Insufficient credits content: application/json: schema: type: object properties: error: type: string example: Insufficient credits required: type: integer example: 1 description: Credits required for this request available: type: integer example: 0 description: Credits currently available required: - error - required - available '500': description: Internal Server Error - Service configuration or processing error content: application/json: schema: type: object properties: error: type: string example: Service configuration error required: - error components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: |- API key for authentication. Format: `sk_live_xxxxxxxxxxxxx` Get your API key from the [Dashboard](https://sociavault.com/dashboard). ````