Popular Posts V1

Get posts from r/popular. Supports sort, time filter, and geo filter. SFW only — use V2 for NSFW.

GET /api/v1/communities/popular-posts/{sort}

Get posts from r/popular. Supports sort, time filter, and geo filter. SFW only — use V2 for NSFW.

Path parameters

Name	Type	Required	Description
`sort`	enum	Yes	Sort: hot, new, top, rising.

Query parameters

Name	Type	Required	Description
`geo_filter`	string	No	Geo filter (e.g. GLOBAL, US). Default: GLOBAL.
`time_filter`	string	No	Time filter (for top): hour, day, week, month, year, all.
`limit`	number	No	Number of posts (1-100). Default: 25.

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/communities/popular-posts/hot?geo_filter=<geo_filter>&time_filter=<time_filter>&limit=25" \
  -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/communities/popular-posts/hot?geo_filter=<geo_filter>&time_filter=<time_filter>&limit=25", {
  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/communities/popular-posts/hot?geo_filter=<geo_filter>&time_filter=<time_filter>&limit=25"
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": {
    "kind": "Listing",
    "data": {
      "after": "t3_1sys4r2",
      "dist": 25,
      "modhash": "",
      "geo_filter": null,
      "children": [
        {
          "kind": "t3",
          "data": {
            "approved_at_utc": null,
            "subreddit": "Fauxmoi",
            "selftext": "",
            "author_fullname": "t2_exampleu",
            "saved": false,
            "mod_reason_title": null,
            "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,
            "pwls": 6,
            "link_flair_css_class": null,
            "downs": 0,
            "thumbnail_height": 140,
            "top_awarded_type": null,
            "hide_score": false,
            "name": "t3_1sys4r2",
            "quarantine": false,
            "link_flair_text_color": "light",
            "upvote_ratio": 0.69,
            "author_flair_background_color": "#fef2f4",
            "ups": 16885,
            "total_awards_received": 0,
            "media_embed": {},
            "thumbnail_width": 140,
            "author_flair_template_id": "f24c50a6-b9f5-11f0-9e96-7eeb22c429c9",
            "is_original_content": false,
            "user_reports": [],
            "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",
            "can_mod_post": false,
            "score": 16885,
            "approved_by": null,
            "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,
            "subreddit_type": "public",
            "created": 1777396063.0,
            "link_flair_type": "text",
            "wls": 6,
            "removed_by_category": null,
            "banned_by": null,
            "author_flair_type": "text",
            "domain": "v.redd.it",
            "allow_live_comments": false,
            "selftext_html": null,
            "likes": null,
            "suggested_sort": "top",
            "banned_at_utc": null,
            "url_overridden_by_dest": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
            "view_count": null,
            "archived": false,
            "no_follow": false,
            "is_crosspostable": false,
            "pinned": false,
            "over_18": false,
            "preview": {
              "images": [
                {
                  "source": "\u2026",
                  "resolutions": "\u2026",
                  "variants": "\u2026",
                  "id": "\u2026"
                }
              ],
              "enabled": false
            },
            "all_awardings": [],
            "awarders": [],
            "media_only": false,
            "link_flair_template_id": "0467d69a-d6d8-11ef-a9ba-16ae90dacafd",
            "can_gild": false,
            "spoiler": false,
            "locked": false,
            "author_flair_text": "You know what, l've grown quite unfond of you deuxmoi",
            "treatment_tags": [],
            "visited": false,
            "removed_by": null,
            "mod_note": null,
            "distinguished": null,
            "subreddit_id": "t5_examples",
            "author_is_blocked": false,
            "mod_reason_by": null,
            "num_reports": null,
            "removal_reason": null,
            "link_flair_background_color": "#ff0572",
            "id": "1sy7ien",
            "is_robot_indexable": true,
            "report_reasons": null,
            "author": "Terrible_Cycle_5983",
            "discussion_type": null,
            "num_comments": 9375,
            "send_replies": false,
            "contest_mode": false,
            "mod_reports": [],
            "author_patreon_flair": false,
            "author_flair_text_color": "dark",
            "permalink": "/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
          }
        },
        {
          "kind": "t3",
          "data": {
            "approved_at_utc": null,
            "subreddit": "Weird",
            "selftext": "",
            "author_fullname": "t2_exampleu",
            "saved": false,
            "mod_reason_title": null,
            "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,
            "pwls": 6,
            "link_flair_css_class": null,
            "downs": 0,
            "thumbnail_height": 140,
            "top_awarded_type": null,
            "hide_score": false,
            "media_metadata": {
              "strnhn61dyxg1": {
                "status": "valid",
                "e": "Image",
                "m": "image/jpg",
                "p": [
                  "\u2026",
                  "\u2026",
                  "\u2026 (4 more items)"
                ],
                "s": {
                  "y": "\u2026",
                  "x": "\u2026",
                  "u": "\u2026"
                },
                "id": "strnhn61dyxg1"
              },
              "bn3qw5k1dyxg1": {
                "status": "valid",
                "e": "Image",
                "m": "image/jpg",
                "p": [
                  "\u2026",
                  "\u2026",
                  "\u2026 (4 more items)"
                ],
                "s": {
                  "y": "\u2026",
                  "x": "\u2026",
                  "u": "\u2026"
                },
                "id": "bn3qw5k1dyxg1"
              }
            },
            "name": "t3_1sys4r2",
            "quarantine": false,
            "link_flair_text_color": "dark",
            "upvote_ratio": 0.93,
            "author_flair_background_color": null,
            "ups": 43756,
            "total_awards_received": 0,
            "media_embed": {},
            "thumbnail_width": 140,
            "author_flair_template_id": null,
            "is_original_content": false,
            "user_reports": [],
            "secure_media": null,
            "is_reddit_media_domain": false,
            "is_meta": false,
            "category": null,
            "secure_media_embed": {},
            "gallery_data": {
              "items": [
                {
                  "caption": "\u2026",
                  "media_id": "\u2026",
                  "is_deleted": "\u2026",
                  "id": "\u2026"
                },
                {
                  "caption": "\u2026",
                  "media_id": "\u2026",
                  "is_deleted": "\u2026",
                  "id": "\u2026"
                }
              ]
            },
            "link_flair_text": null,
            "can_mod_post": false,
            "score": 43756,
            "approved_by": null,
            "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,
            "subreddit_type": "public",
            "created": 1777391359.0,
            "link_flair_type": "text",
            "wls": 6,
            "removed_by_category": null,
            "banned_by": null,
            "author_flair_type": "text",
            "domain": "reddit.com",
            "allow_live_comments": false,
            "selftext_html": null,
            "likes": null,
            "suggested_sort": null,
            "banned_at_utc": null,
            "url_overridden_by_dest": "https://www.reddit.com/r/test/comments/1sys4r2/image_post/",
            "view_count": null,
            "archived": false,
            "no_follow": false,
            "is_crosspostable": false,
            "pinned": false,
            "over_18": false,
            "all_awardings": [],
            "awarders": [],
            "media_only": false,
            "can_gild": false,
            "spoiler": false,
            "locked": false,
            "author_flair_text": null,
            "treatment_tags": [],
            "visited": false,
            "removed_by": null,
            "mod_note": null,
            "distinguished": null,
            "subreddit_id": "t5_examples",
            "author_is_blocked": false,
            "mod_reason_by": null,
            "num_reports": null,
            "removal_reason": null,
            "link_flair_background_color": "",
            "id": "1sy5a90",
            "is_robot_indexable": true,
            "report_reasons": null,
            "author": "Obvious_Shoe7302",
            "discussion_type": null,
            "num_comments": 5920,
            "send_replies": true,
            "contest_mode": false,
            "mod_reports": [],
            "author_patreon_flair": false,
            "author_flair_text_color": null,
            "permalink": "/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)"
      ],
      "before": null
    }
  },
  "error": null,
  "timestamp": "2026-04-29T08:58:59.649726+00:00"
}

Popular Posts V1

On this page