Browsable Browsable Docs

Reddit Search API

Search Reddit posts by query. Like all Browsable execution endpoints, this route returns the standard run envelope with task metadata, run status, and a result payload when the run completes.

POST /v1/reddit/search

Canonical execution route: /v1/tasks/reddit-search/runs. For the live task contract, inspect GET /v1/tasks/reddit-search.

Parameters

Parameter Type Required Description
query string Yes Search query string.

Response
Result Fields
id - Reddit post ID.
title - Post title.
author - Username of the post author.
subreddit - Subreddit name.
score - Post score.
upvoteRatio - Upvote ratio from 0 to 1.
numComments - Comment count.
created - Unix timestamp.
url - Full Reddit URL.
selftext - Post body for text posts.
thumbnail - Thumbnail URL when present.
isVideo - Whether the post is a video.

Code Examples

curl -X POST "https://api.browsable.app/v1/reddit/search" \

  -H "Authorization: Bearer YOUR_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{"query":"artificial intelligence","_run":{"async":false}}'

Try it Out

API Playground

Stored locally only

Search query

Error Codes

400 Bad Request
The JSON body does not match the task input schema.
401 Unauthorized
Missing or invalid API key.
403 Forbidden
Your account cannot execute the task, usually because of access or credits.
500 Internal Server Error
Reddit search failed upstream.