Browsable Browsable Docs

Reddit Search API

Search Reddit for posts matching a query and get structured data including titles, authors, scores, and more.

GET /v1/reddit/search

Parameters

Parameter Type Required Description
q string Yes Search query (max 500 characters)
limit number No Max results (1-100, default: 10)
sort string No One of: relevance, top, new (default: relevance)

Response

Returns an array of Reddit posts matching the search query. Response also includes credit usage fields.

Response Fields
id - Unique Reddit post ID
title - Post title
author - Username of the post author
subreddit - Name of the subreddit
score - Current upvote score
upvoteRatio - Ratio of upvotes to total votes (0-1)
numComments - Total number of comments
created - Unix timestamp of post creation
url - Full URL to the Reddit post
selftext - Text content (if text post)
thumbnail - URL to post thumbnail (optional)
isVideo - Whether the post is a video

Code Examples

Try it Out

API Playground

Stored locally only

Search query (e.g., "programming", "machine learning")

Max results (1-100)

relevance | top | new

Error Codes

400 Bad Request
Query parameter is missing or exceeds 500 characters
401 Unauthorized
Missing or invalid API key
403 Forbidden
Active subscription required
500 Internal Server Error
Reddit search failed or timed out
Credits: This endpoint deducts credits per request. See Authentication for details.