Search Reddit posts by query API

One call returns posts with media (videos, images, galleries) matching a search query. Each item is a post with embedded media URLs, thumbnails, and streaming links. The sample shows 3 posts; use `nextPage` to fetch more.

2 live routes 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	search-mediaCHEAPEST`GET search-media`	$0.00015$0.15 / 1k calls	✓ 2026-10-06pricing ↗
reddit-comRapidAPI listing	subreddit/search`GET subreddit/search`	$0.00015$0.15 / 1k calls	✓ 2026-10-06pricing ↗

What it returns

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

data[].idPost ID (t3_ prefix)data[].postTitlePost titledata[].media.typeHintMedia type (VIDEO, IMAGE, etc.)data[].media.streaming.hlsUrlHLS video stream URLdata[].media.packagedMedia.muxedMp4s.recommended.urlRecommended MP4 download URLdata[].scorePost upvote scoredata[].subreddit.nameSubreddit namedata[].createdAtWhen post was createddata[].authorInfo.namePost author username

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/search-media$0.00015 / call✓ working · tested 2026-10-061.10 s latency

Parameters

Parameter	Type		Notes
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`
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
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`
query	string · query	required	- Required: true - Ex: `gaming` · default gaming

HTTP

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

MCP

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

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

{
  "data": [
    {
      "id": "t3_1bi0e6p",
      "url": "https://v.redd.it/joeieh4uf5pc1",
      "poll": null,
      "flair": {
        "text": "Where men cried🤧🤧🥺",
        "type": "richtext",
        "richtext": "[{\"e\":\"text\",\"t\":\"Where men cried🤧🤧🥺\"}]",
        "template": {
          "id": "efab6e22-78f1-11ea-8a4b-0e9cf4248ae9",
          "isEditable": false,
          "backgroundColor": "#9E8D49"
        },
        "textColor": "DARK",
        "__typename": "PostFlair"
      },
      "media": {
        "still": {
          "large": {
            "url": "https://external-preview.redd.it/ajhucnRtdHRmNXBjMdiMIsMdqAT…",
            "__typename": "MediaSource",
            "dimensions": {
              "width": "…",
              "height": "…"
            }
          },
          "small": {
            "url": "https://external-preview.redd.it/ajhucnRtdHRmNXBjMdiMIsMdqAT…",
            "__typename": "MediaSource",
            "dimensions": {
              "width": "…",
              "height": "…"
            }
          },
          "medium": {
            "url": "https://external-preview.redd.it/ajhucnRtdHRmNXBjMdiMIsMdqAT…",
            "__typename": "MediaSource",
            "dimensions": {
              "width": "…",
              "height": "…"
            }
          },
          "source": {
            "url": "https://external-preview.redd.it/ajhucnRtdHRmNXBjMdiMIsMdqAT…",
            "__typename": "MediaSource",
            "dimensions": {
              "width": "…",
              "height": "…"
            }
          },
          "xlarge": {
            "url": "https://external-preview.redd.it/ajhucnRtdHRmNXBjMdiMIsMdqAT…",
            "__typename": "MediaSource",
            "dimensions": {
              "width": "…",
              "height": "…"
            }
          },
          "altText": null,
          "xxlarge": {
            "url": "https://external-preview.redd.it/ajhucnRtdHRmNXBjMdiMIsMdqAT…",
            "__typename": "MediaSource",
            "dimensions": {
              "width": "…",
              "height": "…"
            }
          },
          "xxxlarge": {
            "url": "https://external-preview.redd.it/ajhucnRtdHRmNXBjMdiMIsMdqAT…",
            "__typename": "MediaSource",
            "dimensions": {
              "width": "…",
              "height": "…"
            }
          },
          "__typename": "StillMedia"
        },
        "video": null,
        "animated": null,
        "download": {
          "url": "https://packaged-media.redd.it/joeieh4uf5pc1/dl/m2-res_720p.…",
          "__typename": "MediaDownload"
        },
        "typeHint": "VIDEO",
        "streaming": {
          "isGif": false,
          "hlsUrl": "https://cf.v.redd.it/joeieh4uf5pc1/HLSPlaylist.m3u8?f=sd%2Cs…",
          "dashUrl": "https://cf.v.redd.it/joeieh4uf5pc1/DASHPlaylist.mpd?f=sd%2Cs…",
          "duration": 5,
          "__typename": "StreamingMedia",
          "dimensions": {
            "width": 1280,
            "height": 720
          },
          "scrubberMediaUrl": "https://v.redd.it/joeieh4uf5pc1/DASH_96.mp4"
        },
        "__typename": "Media",
        "packagedMedia": {
          "muxedMp4s": {
            "low": {
              "url": "…"
            },
            "high": {
              "url": "…"
            },
            "medium": {
              "url": "…"
            },
            "highest": {
              "url": "…"
            },
            "recommended": {
              "url":
…

Other routes for this job

reddit-com · subreddit/search$0.00015

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

Parameters

Parameter	Type		Notes
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: `dDNfZXJ4dXdt`
time	string · query	optional	- Time - Default: `all` - Choose one of the values below - `all`: All time - `hour`: Past hour - `day`: Past 24 hours - `week`: Past week - `month`: Past month - `year`: Past year · one of all, hour, day, week, month, yeare.g. `all`
sort	string · query	optional	- Sort by - Default: `top` - Choose one of the values below - `hot`: Hot - `new`: New - `top`: Top - `controversial`: Controversial - `rising`: Rising · one of hot, new, top, controversial, risinge.g. `hot`
query	string · query	required	- Required: true - Ex: `gaming` · default gaming

HTTP

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

MCP

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

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 query, sort, and time rangefrom $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