Search APIs
Loading…
← API Store
Social

Reddit

Reddit

Search Reddit posts

GET /reddit/v1/search
Test this endpoint

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
qrequiredstring Example: rust programming
sortstringrelevance (default), hot, top, new, comments. Example: relevance
timeall | year | month | week | day | hourTime range: all (default), year, month, week, day, hour.
subredditstringSearch inside one subreddit.
enginefeed | webfeed (default): 25 posts per page with text and links. web: the results of reddit.com's search box, with votes, comment counts and NSFW/spoiler flags (about 7 per page). Pass the same engine with the cursor.
cursorstringValue of `next_cursor` from the previous page.

Every endpoint also takes: raw、fields、fresh、output、records

{
  "count": 22,
  "credits_used": 1,
  "feed": {
    "category": " reddit.com",
    "category_label": "r/ reddit.com",
    "icon": null,
    "logo": null,
    "subtitle": null,
    "title": "reddit.com: search results - rust programming",
    "updated": "2026-10-25T22:38:47+00:00",
    "url": "https://www.reddit.com/search?q=rust+programming&sort=relevance&t=all&limit=25"
  },
  "next_cursor": "t3_1127kgj",
  "posts": [
    {
      "author": "TheWanderingAnimimo",
      "author_url": "https://www.reddit.com/user/TheWanderingAnimimo",
      "category_label": "r/AskProgramming",
      "content_html": "<!-- SC_OFF --><div class=\"md\"><p>Is there a particular reason why specifically Rust is used? Is it the new C++?</p> <p>edit; thank you all …",
      "external_url": null,
      "id": "t3_1x79ycz",
      "images": [],
      "link": null,
      "links": [],
      "media_thumbnail": null,
      "permalink": "/r/AskProgramming/comments/1x79ycz/why_are_all_vibecoded_programs_and_games_i_see/",
      "published": "2026-10-16T07:40:15+00:00",
      "subreddit": "AskProgramming",
      "text": "Is there a particular reason why specifically Rust is used? Is it the new C++?\n edit; thank you all for the comments, I've learnt alot!",
      "thumbnail": null,
      "title": "Why are all vibecoded programs and games I see coded in Rust?",
      "updated": "2026-10-16T07:40:15+00:00",
      "url": "https://www.reddit.com/r/AskProgramming/comments/1x79ycz/why_are_all_vibecoded_programs_and_games_i_see/",
      "videos": []
    },
    {
      "author": "ritman-octos",
      "author_url": "https://www.reddit.com/user/ritman-octos",
      "category_label": "r/rust",
      "content_html": "<!-- SC_OFF --><div class=\"md\"><p>I have been making scripts with other languages like js and python and bash without learning the the whole…",
      "external_url": null,
      "id": "t3_1x5b4v5",
      "images": [],
      "link": null,
      "links": [],
      "media_thumbnail": null,
      "permalink": "/r/rust/comments/1x5b4v5/rust_as_a_first_serious_programming_language/",
      "published": "2026-10-13T22:46:54+00:00",
      "subreddit": "rust",
      "text": "I have been making scripts with other languages like js and python and bash without learning the the whole language and getting serious with…",
      "thumbnail": null,
      "title": "Rust as a first serious programming language",
      "updated": "2026-10-13T22:46:54+00:00",
      "url": "https://www.reddit.com/r/rust/comments/1x5b4v5/rust_as_a_first_serious_programming_language/",
      "videos": []
    },
    "… 20 more"
  ],
  "query": "rust programming",
  "sort": "relevance",
  "subreddit": null,
  "time": "all"
}
Response fields (38)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.countinteger
$.credits_usedinteger
$.feedobject
$.feed.categorystring
$.feed.category_labelstring
$.feed.iconnull
$.feed.logonull
$.feed.subtitlenull
$.feed.titlestring
$.feed.updatedstring
$.feed.urlstring
$.next_cursorstring
$.postsarray
$.posts[]object | string
$.posts[].authorstring
$.posts[].author_urlstring
$.posts[].category_labelstring
$.posts[].content_htmlstring
$.posts[].external_urlnull
$.posts[].idstring
$.posts[].imagesarray
$.posts[].linknull
$.posts[].linksarray
$.posts[].media_thumbnailnull
$.posts[].permalinkstring
$.posts[].publishedstring
$.posts[].subredditstring
$.posts[].textstring
$.posts[].thumbnailnull
$.posts[].titlestring
$.posts[].updatedstring
$.posts[].urlstring
$.posts[].videosarray
$.querystring
$.sortstring
$.subredditnull
$.timestring