Search
Keyword search across Reddit with scope (post, comment, subreddit), sort and time-range filters. Returns ranked matches with subreddit context and engagement metrics — used for brand mentions, competitor chatter and demand research.
What you get
Each call returns up to 20 posts, plus a cursor for the next 20.
Endpoint
GET /v1/reddit/search
Price
$1.50
per 1,000 calls · $0.0015 per call
Cost per call
1 credit
Failed calls never charged
Parameters
The Reddit handle, URL or identifier to resolve.
Maximum records to return, capped at this service's page size (see Limits below). Omit it to receive the whole page. It shapes the response, not the price — a call costs the same either way.
Pagination cursor returned by a previous response.
Bypass cached data and force a live fetch for this one call. Use it for daily monitoring or any figure you are tracking over time. Accepts `true`, `1`, `false` or `0`; anything else returns 400 `invalid_fresh`. Defaults to false and costs exactly the same as a cached call.
One of: true, 1, false, 0
Example request
Live call. Successful calls are charged; failed and empty results are not.
curl "https://fastfetchz.com/v1/reddit/search?target=nasa" \
-H "X-API-Key: $FASTFETCHZ_KEY"Example response
{
"success": true,
"service": {
"platform": "Reddit",
"name": "Search",
"slug": "search"
},
"credits_charged": 1,
"credits_remaining": 99,
"latency_ms": 214,
"data": {
"posts": [
{
"id": "fwtchk",
"author": "Pluto_and_Charon",
"author_fullname": "t2_zh67r",
"subreddit": "space",
"title": "NASA has granted $2 million to develop a concept for a space telescope that could take images of planets around other stars detailed enough to make out landmasses and vegetation cover",
"selftext": null,
"selftext_html": null,
"downs": 0,
"name": "t3_fwtchk",
"upvote_ratio": null,
"ups": 19745,
"total_awards_received": null,
"score": 19745,
"created": 1586295721,
"created_utc": 1586295721,
"created_at_iso": "2020-04-07T21:42:01.000Z",
"num_comments": 602,
"url": "https://www.reddit.com/r/space/comments/fwtchk/nasa_has_granted_2_million_to_develop_a_concept/",
"permalink": "/r/space/comments/fwtchk/nasa_has_granted_2_million_to_develop_a_concept/",
"subreddit_subscribers": null,
"is_video": false,
"over_18": false,
"spoiler": false,
"relative_position": 0
},
{
"id": "vrfiwj",
"author": "ajamesmccarthy",
"author_fullname": "t2_n7x4x",
"subreddit": "pics",
"title": "A photo taken using a $16B space telescope versus the same object with a $500 scope from my backyard",
"selftext": null,
"selftext_html": null,
"downs": 0,
"name": "t3_vrfiwj",
"upvote_ratio": null,
"ups": 11764,
"total_awards_received": null,
"score": 11764,
"created": 1656963659,
"created_utc": 1656963659,
"created_at_iso": "2022-07-04T19:40:59.000Z",
"num_comments": 474,
"url": "https://www.reddit.com/r/pics/comments/vrfiwj/a_photo_taken_using_a_16b_space_telescope_versus/",
"permalink": "/r/pics/comments/vrfiwj/a_photo_taken_using_a_16b_space_telescope_versus/",
"subreddit_subscribers": null,
"is_video": false,
"over_18": false,
"spoiler": false,
"relative_position": 1
}
],
"after": "eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiM1wiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIzXCIsXCJzZWN0aW9uXzJfcGlwZWxpbmVfMTFfcXVlcnlfc3VnZ2VzdGlvbnNcIjpcIjZcIixcInNlY3Rpb25fMl9waXBlbGluZV84X3Bvc3Rfc2VhcmNoXCI6XCI3XCIsXCJzZWN0aW9uXzNfcGlwZWxpbmVfMF9zdWJyZWRkaXRfc2VhcmNoXCI6XCI1XCIsXCJzZWN0aW9uXzNfcGlwZWxpbmVfMV9hdXRob3Jfc2VhcmNoXCI6…"
}
}Getting more results
Each response includes a cursor. Pass it back as cursor to fetch the next 20 posts. Repeat until no cursor is returned.
# Call 1 — first 20 posts
curl "https://fastfetchz.com/v1/reddit/search?target=nasa" \
-H "X-API-Key: $FASTFETCHZ_KEY"
# -> { "data": { ... }, "cursor": "eyJwYWdlIjoyfQ" }
# Call 2 — next 20 posts
curl "https://fastfetchz.com/v1/reddit/search?target=nasa&cursor=eyJwYWdlIjoyfQ" \
-H "X-API-Key: $FASTFETCHZ_KEY"Limits
- Maximum per call: 20 posts.
- Minimum per call: 1 post — a target with less data returns fewer posts, and an empty result is still a successful call.
- Pass limit to receive fewer than 20 posts. It shapes the response, not the price.
- Larger jobs are paginated with a cursor; there is no cap on how many pages you fetch.
What this costs in practice
200,000 posts = 10,000 calls × 1 credits per call = 10,000 credits = $0.00
Priced at the Custom pack rate: 1,000,000 credits for $0.00.
Open in the pricing calculator