Subreddit post search
Posts in one subreddit that match a search.
GET/v1/reddit/subreddits/search1 creditHeaders
Get your API keyx-api-key*stringrequiredheaderYour API key, made in the dashboard.
Parameters
6q*stringrequiredqueryWhat to search for.
min 1 chars · max 200 chars · example: push ups
subredditstringoptionalqueryA subreddit's name, without r/. Give subreddit or url.
example: Fitness
urlstringoptionalqueryA subreddit's link: reddit.com/r/<name>, with anything after it. Give subreddit or url.
max 300 chars
sortenumoptionalqueryThe order: relevance, hot, top, new, or comments (most commented first).
one of: relevance, hot, top, new, comments · default: relevance
timeenumoptionalqueryWith sort relevance, top or comments: how far back to search.
one of: hour, day, week, month, year, all
cursorstringoptionalqueryFor the next page: page.next_cursor from the page before. Send the other parameters again with it.
Response fields
23dataarrayThe result: one object, or a list for the endpoints that return several.
data[].idstringThe post's id, with Reddit's t3_ prefix.
data[].urlstringThe post's link.
data[].titlestringnullableIts title.
data[].textstringnullableIts own text, for a text post.
data[].authorstringnullableIts author's username, without u/.
data[].subredditstringnullableThe subreddit it is in, without r/.
data[].scoreintegernullableUpvotes minus downvotes.
data[].comment_countintegernullableHow many comments it has.
data[].upvote_rationumbernullableThe share of its votes that are upvotes, from 0 to 1.
data[].post_typestringnullableReddit's name for the kind of post, such as "text", "link" or "multi_media".
data[].created_atstringnullableWhen it was posted.
format: date-time
pageobjectnullablePaging, for the endpoints that page; null for the others.
page.next_cursorstringnullableSend it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.
page.has_morebooleanoptionalWhether another page follows.
default: false
metaobjectAbout this call.
meta.platformstringThe platform: reddit, threads, tiktok or youtube.
meta.endpointstringThe endpoint's name, such as channel_videos.
meta.paramsobjectThe call's parameters, defaults included. Parameters without a value, and the cursor, are left out.
meta.request_idstringThis call's id. Quote it when you report a problem.
meta.api_versionstringThe API version that answered.
meta.fetched_atstringWhen the data was fetched from the platform (UTC).
format: date-time
meta.cachedbooleanoptionalWhether it came from our cache; fetched_at says how old it is.
default: false
Code example
curl -X GET 'https://api.socialparse.dev/v1/reddit/subreddits/search?q=push+ups&subreddit=Fitness' \ -H 'x-api-key: YOUR_API_KEY'Responses
Successful Response
{ "data": [ { "id": "string", "url": "string", "title": "string", "text": "string", "author": "string", "subreddit": "string", "score": 0, "comment_count": 0, "upvote_ratio": 0, "post_type": "string", "created_at": "2019-08-24T14:15:22Z" } ], "page": { "next_cursor": "string", "has_more": false }, "meta": { "platform": "string", "endpoint": "string", "params": { "property1": "string", "property2": "string" }, "request_id": "string", "api_version": "string", "fetched_at": "2019-08-24T14:15:22Z", "cached": false }}