Search Reddit posts by query, sort, and time range API

One call returns up to 5 Reddit posts matching a search query, sorted by relevance or other criteria. Each item is a post with title, score, subreddit, media, and metadata. The answer shows the first page; pagination uses the `nextPage` parameter (cursor-based).

1 live route on Reddit, from $0.00015 per call. Every route below answered our last live test on 2026-10-06; the gateway re-tests them daily.

Get a key See it in the catalog Use it from MCP

Price per call, by route

The upstream price you are metered at, cheapest first. A route without a published price says so.

Provider	Endpoint	Price	Tested
reddit-comRapidAPI listing	posts/search-posts`GET posts/search-posts`	$0.00015$0.15 / 1k calls	✓ 2026-10-06pricing ↗

What it returns

From a real call to the route: reddit-com.

data[].idPost ID (t3_...)data[].postTitlePost titledata[].subreddit.nameSubreddit namedata[].subreddit.prefixedNameSubreddit name with r/ prefixdata[].scorePost upvote scoredata[].upvoteRatioRatio of upvotes to total votes (0-1)data[].commentCountNumber of commentsdata[].createdAtPost creation timestampdata[].urlURL of the post or linked contentdata[].postHintPost type (HOSTED_VIDEO, IMAGE, LINK, etc.)data[].media.video.streaming.hlsUrlHLS stream URL for video postsdata[].authorInfo.namePost author usernamedata[].isNsfwBoolean: whether post is NSFWdata[].flair.textPost flair/tag

Call it

HTTP with your key in x-api-key, or the call_endpoint tool of our MCP server.

GET /api/gw/rapidapi-reddit-com/posts/search-posts$0.00015 / call✓ working · tested 2026-10-062.10 s latency

Parameters

Parameter	Type		Notes
sort	string · query	optional	- Sort by - Default: `relevance` - Choose one of the values below - `relevance`: Relevance - `hot`: Hot - `top`: Top - `new`: New - `comments`: Comment count · one of relevance, hot, top, new, commentse.g. `relevance`
nextPage	string · query	optional	- The page index, for paging purpose - Leave it blank for the first time - The `nextPage` can be retrieved from response of this endpoint(meta->nextPage) - Ex: `MjQ=`
nsfw	boolean · query	optional	- Whether to retrieve content that is not safe for work (e.g., 18+ content) - Default: `false` - The `true` is yes, the `false` is no
time	string · query	optional	- Time - Default: `all` - Choose one of the values below - `all`: All time - `year`: Past year - `month`: Past month - `week`: Past week - `day`: Today - `hour`: Past hour · one of all, year, month, week, day, houre.g. `all`
query	string · query	required	- Required: true - Ex: `gaming` · default gaming

HTTP

curl "https://fetchapi.co/api/gw/rapidapi-reddit-com/posts/search-posts?sort=relevance&time=all&query=gaming" \
  -H "x-api-key: YOUR_KEY"

MCP

call_endpoint("rapidapi-reddit-com.posts_search_posts", {"sort": "relevance", "time": "all", "query": "gaming"})

Real example answer (trimmed) · 2026-10-03

{
  "data": [
    {
      "id": "t3_1wt5lc6",
      "url": "https://v.redd.it/qllh0gp2ifsh1",
      "poll": null,
      "flair": {
        "text": "Funny",
        "type": "richtext",
        "richtext": "[{\"e\":\"text\",\"t\":\"Funny\"}]",
        "template": {
          "id": "10f14a5e-092a-11e9-9566-0e149a3c887c",
          "isEditable": false,
          "backgroundColor": "#DADADA"
        },
        "textColor": "DARK",
        "__typename": "PostFlair"
      },
      "media": {
        "still": {
          "large": {
            "url": "https://external-preview.redd.it/dXR4amtqaDJpZnNoMQnBZPWN0CH…",
            "__typename": "MediaSource",
            "dimensions": {
              "width": "…",
              "height": "…"
            }
          },
          "small": {
            "url": "https://external-preview.redd.it/dXR4amtqaDJpZnNoMQnBZPWN0CH…",
            "__typename": "MediaSource",
            "dimensions": {
              "width": "…",
              "height": "…"
            }
          },
          "medium": {
            "url": "https://external-preview.redd.it/dXR4amtqaDJpZnNoMQnBZPWN0CH…",
            "__typename": "MediaSource",
            "dimensions": {
              "width": "…",
              "height": "…"
            }
          },
          "source": {
            "url": "https://external-preview.redd.it/dXR4amtqaDJpZnNoMQnBZPWN0CH…",
            "__typename": "MediaSource",
            "dimensions": {
              "width": "…",
              "height": "…"
            }
          },
          "xlarge": null,
          "altText": null,
          "xxlarge": null,
          "xxxlarge": null,
          "__typename": "StillMedia"
        },
        "video": null,
        "animated": null,
        "download": {
          "url": "https://packaged-media.redd.it/qllh0gp2ifsh1/dl/m2-res_1280p…",
          "__typename": "MediaDownload"
        },
        "typeHint": "VIDEO",
        "streaming": {
          "isGif": false,
          "hlsUrl": "https://v.redd.it/qllh0gp2ifsh1/HLSPlaylist.m3u8?f=sd%2Csubs…",
          "dashUrl": "https://v.redd.it/qllh0gp2ifsh1/DASHPlaylist.mpd?f=sd%2Csubs…",
          "duration": 41,
          "__typename": "StreamingMedia",
          "dimensions": {
            "width": 720,
            "height": 1280
          },
          "scrubberMediaUrl": "https://v.redd.it/qllh0gp2ifsh1/CMAF_96.mp4"
        },
        "__typename": "Media",
        "packagedMedia": {
          "muxedMp4s": {
            "low": {
              "url": "…"
            },
            "high": {
              "url": "…"
            },
            "medium": {
              "url": "…"
            },
            "highest": {
              "url": "…"
            },
            "recommended": {
              "url": "…"
            }
          },
          "__typename": "PackagedMedia"
        },
        "previewMediaId": "dXR4amtqaDJpZnNoMQnBZPWN0CHKaktJtYkjFP1l_SMucqjrjnpU9Kg0Wsqn",
        "obfuscated_still": {
          "large": null,
          "small": null,
          "medium": null,
          "source": null,
          "xlarge": null,
          "xxlarge": null,
          "xxxlarge": null,
          "__typename": "StillMedia"
        }
      },
      "score": 3713,
      "domain": "v.redd.it",
      "isNsfw": false,
      "content": null,
      "gallery": null,
      "isSaved": false,
      "editedAt": null,
      "isHidden": false,
      "isLocked": false,
      "…": "40 more fields"
    },
    "… 3 more"
  ],
  "meta
…

Related Reddit APIs

All 8 Reddit jobs →

Autocomplete Reddit subreddits and user profiles by queryfrom $0.00015
Get a Reddit post's award totalsfrom $0.00015
Get a Reddit post's comments by post IDfrom $0.00015
Search Reddit comments by queryfrom $0.00015
Search Reddit communities by namefrom $0.00015
Search Reddit posts by queryfrom $0.00015
Search Reddit users by usernamefrom $0.00015

One key for every API on this page.

Call it over HTTP or from any MCP client. Each key has a rate limit and a monthly cap; calls are metered at the upstream price.

Get a key Set up MCP Browse the catalog