scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTPost
  • POSTSearch

Reddit Search

1 credit

Search Reddit for posts and comments.

POST/api/v1/tools/reddit/search

Parameters

querystringrequired

Search query string.

fieldsstring[]

Fields to include per post/comment. Post defaults: id, author, title, text, score, createdAt, subreddit, numComments. Comment defaults: id, author, text, score, createdAt, subreddit, parentId, parentPostTitle. Use ["*"] for all fields. Available fields: id, author, title, text, score, createdAt, subreddit, numComments, parentId, url, parentPostTitle, parentPostUrl.

Response Schema

dataobject

Reddit search result

postsobject[]

Matching posts. Default fields: id, author, title, text, score, createdAt, subreddit, numComments.

commentsobject[]

Matching comments. Default fields: id, author, text, score, createdAt, subreddit, parentId, parentPostTitle.

countnumber

Total number of posts and comments returned

metaobject

Request metadata

toolstring

Tool name (reddit-search)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/reddit/search \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
"query": "best rust web frameworks"
}'

Response Example

{
"data": {
"posts": [
{
"id": "t3_abc123",
"author": "rustacean",
"title": "Best Rust web frameworks in 2026?",
"text": "I have been comparing Actix, Axum, and Rocket...",
"createdAt": "2026-04-07T10:00:00.000Z",
"url": "https://www.reddit.com/r/rust/comments/abc123/best_rust_web_frameworks/",
"score": 256,
"numComments": 89,
"subreddit": "r/rust"
}
],
"comments": [
{
"id": "t1_xyz789",
"parentId": "t3_abc123",
"author": "web_dev",
"text": "Axum has the best ergonomics in my experience.",
"createdAt": "2026-04-07T11:30:00.000Z",
"score": 45,
"subreddit": "r/rust",
"parentPostTitle": "Best Rust web frameworks in 2026?"
}
],
"count": 2
},
"meta": {
"tool": "reddit-search",
"creditsUsed": 1,
"requestId": "req_abc123"
}
}