Best Posts V1

Get posts from Reddit's front page. Supports sort: best, hot, new, top, rising, controversial. SFW only — use V2 for NSFW.

GET /api/v1/publishing/best

Get posts from Reddit's front page. Supports sort: best, hot, new, top, rising, controversial. SFW only — use V2 for NSFW.

Query parameters

Name	Type	Required	Description
`limit`	number	No	Max posts to return (1-500, default: 25)
`after`	string	No	Pagination cursor (fullname from previous response)
`sort`	string	No	Sort order: best, hot, new, top, rising, controversial (default: best)
`time_filter`	string	No	Time filter for top/controversial: hour, day, week, month, year, all

Authentication

Header	Value
`X-RapidAPI-Key`	Your RapidAPI key
`X-RapidAPI-Host`	`red-crawler1.p.rapidapi.com`

Example request

cURL

curl -X GET "https://red-crawler1.p.rapidapi.com/api/v1/publishing/best?limit=25&after=t3_1sys4r2&sort=best&time_filter=<time_filter>" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com"

JavaScript

const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v1/publishing/best?limit=25&after=t3_1sys4r2&sort=best&time_filter=<time_filter>", {
  method: "GET",
  headers: {
      "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
    }
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v1/publishing/best?limit=25&after=t3_1sys4r2&sort=best&time_filter=<time_filter>"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
}
resp = requests.get(url, headers=headers)
print(resp.json())

Example response

HTTP 200 — captured from a live call to the gateway.

{
  "success": true,
  "data": {
    "posts": [
      {
        "subreddit": "Fauxmoi",
        "selftext": "",
        "author_fullname": "t2_exampleu",
        "saved": false,
        "gilded": 0,
        "clicked": false,
        "title": "Billie Eillish's hill to die on: \"eating meat is inherently wrong.\"",
        "link_flair_richtext": [],
        "subreddit_name_prefixed": "r/Fauxmoi",
        "hidden": false,
        "link_flair_css_class": null,
        "downs": 0,
        "thumbnail_height": 140,
        "hide_score": false,
        "name": "t3_1sys4r2",
        "quarantine": false,
        "link_flair_text_color": "light",
        "upvote_ratio": 0.69,
        "author_flair_background_color": "#fef2f4",
        "ups": 16888,
        "total_awards_received": 0,
        "media_embed": {},
        "thumbnail_width": 140,
        "is_original_content": false,
        "secure_media": {
          "reddit_video": {
            "bitrate_kbps": 5000,
            "fallback_url": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
            "has_audio": true,
            "height": 1920,
            "width": 1080,
            "scrubber_media_url": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
            "dash_url": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
            "duration": 22,
            "hls_url": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
            "is_gif": false,
            "transcoding_status": "completed"
          }
        },
        "is_reddit_media_domain": true,
        "is_meta": false,
        "category": null,
        "secure_media_embed": {},
        "link_flair_text": "APPROVED B-LISTERS",
        "score": 16888,
        "is_created_from_ads_ui": false,
        "author_premium": false,
        "thumbnail": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "edited": false,
        "author_flair_css_class": null,
        "author_flair_richtext": [],
        "gildings": {},
        "post_hint": "hosted:video",
        "content_categories": null,
        "is_self": false,
        "created": 1777396063.0,
        "link_flair_type": "text",
        "removed_by_category": null,
        "author_flair_type": "text",
        "domain": "v.redd.it",
        "allow_live_comments": false,
        "selftext_html": null,
        "likes": null,
        "suggested_sort": "top",
        "url_overridden_by_dest": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "archived": false,
        "is_crosspostable": false,
        "pinned": false,
        "over_18": false,
        "preview": {
          "images": [
            {
              "source": {
                "url": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
                "width": 1080,
                "height": 1920
              },
              "resolutions": [
                {
                  "url": "\u2026",
                  "width": "\u2026",
                  "height": "\u2026"
                },
                {
                  "url": "\u2026",
                  "width": "\u2026",
                  "height": "\u2026"
                },
                "\u2026 (4 more items)"
              ],
              "variants": {},
              "id": "Mndob3pwdHlxeXhnMcVTVvdxQNLE1xZA1TQ7xBHOl-vs4ako6fVjoNByD-BR"
            }
          ],
          "enabled": false
        },
        "all_awardings": [],
        "spoiler": false,
        "locked": false,
        "author_flair_text": "You know what, l've grown quite unfond of you deuxmoi",
        "visited": false,
        "removed_by": null,
        "distinguished": null,
        "subreddit_id": "t5_examples",
        "author_is_blocked": false,
        "link_flair_background_color": "#ff0572",
        "id": "1sy7ien",
        "author": "Terrible_Cycle_5983",
        "num_comments": 9374,
        "send_replies": false,
        "contest_mode": false,
        "author_flair_text_color": "dark",
        "permalink": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "stickied": false,
        "url": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "subreddit_subscribers": 6728451,
        "created_utc": 1777396063.0,
        "num_crossposts": 10,
        "media": {
          "reddit_video": {
            "bitrate_kbps": 5000,
            "fallback_url": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
            "has_audio": true,
            "height": 1920,
            "width": 1080,
            "scrubber_media_url": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
            "dash_url": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
            "duration": 22,
            "hls_url": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
            "is_gif": false,
            "transcoding_status": "completed"
          }
        },
        "is_video": true
      },
      {
        "subreddit": "Weird",
        "selftext": "",
        "author_fullname": "t2_exampleu",
        "saved": false,
        "gilded": 0,
        "clicked": false,
        "is_gallery": true,
        "title": "What kind of mosquito is this?\ud83d\ude33\ud83d\ude33",
        "link_flair_richtext": [],
        "subreddit_name_prefixed": "r/Weird",
        "hidden": false,
        "link_flair_css_class": null,
        "downs": 0,
        "thumbnail_height": 140,
        "hide_score": false,
        "media_metadata": {
          "strnhn61dyxg1": {
            "status": "valid",
            "e": "Image",
            "m": "image/jpg",
            "p": [
              {
                "y": 143,
                "x": 108,
                "u": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/"
              },
              {
                "y": 287,
                "x": 216,
                "u": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/"
              },
              "\u2026 (4 more items)"
            ],
            "s": {
              "y": 1438,
              "x": 1080,
              "u": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/"
            },
            "id": "strnhn61dyxg1"
          },
          "bn3qw5k1dyxg1": {
            "status": "valid",
            "e": "Image",
            "m": "image/jpg",
            "p": [
              {
                "y": 144,
                "x": 108,
                "u": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/"
              },
              {
                "y": 288,
                "x": 216,
                "u": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/"
              },
              "\u2026 (4 more items)"
            ],
            "s": {
              "y": 1440,
              "x": 1080,
              "u": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/"
            },
            "id": "bn3qw5k1dyxg1"
          }
        },
        "name": "t3_1sys4r2",
        "quarantine": false,
        "link_flair_text_color": "dark",
        "upvote_ratio": 0.93,
        "author_flair_background_color": null,
        "ups": 43755,
        "total_awards_received": 0,
        "media_embed": {},
        "thumbnail_width": 140,
        "is_original_content": false,
        "secure_media": null,
        "is_reddit_media_domain": false,
        "is_meta": false,
        "category": null,
        "secure_media_embed": {},
        "gallery_data": {
          "items": [
            {
              "caption": "",
              "media_id": "strnhn61dyxg1",
              "is_deleted": false,
              "id": 923986080
            },
            {
              "caption": "",
              "media_id": "bn3qw5k1dyxg1",
              "is_deleted": false,
              "id": 923986081
            }
          ]
        },
        "link_flair_text": null,
        "score": 43755,
        "is_created_from_ads_ui": false,
        "author_premium": false,
        "thumbnail": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "edited": false,
        "author_flair_css_class": null,
        "author_flair_richtext": [],
        "gildings": {},
        "content_categories": null,
        "is_self": false,
        "created": 1777391359.0,
        "link_flair_type": "text",
        "removed_by_category": null,
        "author_flair_type": "text",
        "domain": "reddit.com",
        "allow_live_comments": false,
        "selftext_html": null,
        "likes": null,
        "suggested_sort": null,
        "url_overridden_by_dest": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "archived": false,
        "is_crosspostable": false,
        "pinned": false,
        "over_18": false,
        "all_awardings": [],
        "spoiler": false,
        "locked": false,
        "author_flair_text": null,
        "visited": false,
        "removed_by": null,
        "distinguished": null,
        "subreddit_id": "t5_examples",
        "author_is_blocked": false,
        "link_flair_background_color": "",
        "id": "1sy5a90",
        "author": "Obvious_Shoe7302",
        "num_comments": 5920,
        "send_replies": true,
        "contest_mode": false,
        "author_flair_text_color": null,
        "permalink": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "stickied": false,
        "url": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
        "subreddit_subscribers": 3379283,
        "created_utc": 1777391359.0,
        "num_crossposts": 19,
        "media": null,
        "is_video": false
      },
      "\u2026 (23 more items)"
    ],
    "cursor": "t3_1sys4r2"
  },
  "error": null,
  "timestamp": "2026-04-29T08:58:45.151242+00:00"
}