Subreddit

Description

Retrieve detailed information about a specific subreddit, including icons, rules, custom widgets of the subreddit and moderators.

Endpoint

GET api/v1/realtime/social/reddit/v1/subreddit/{name}/info

Parameters

Param
Required
Param Type
Description

name

Yes

Path Param

String | The subreddit name

chevron-rightExample Requesthashtag
curl -X GET 'https://api.webit.live/api/v1/realtime/social/reddit/v1/subreddit/hmmm/info' \
--header 'Authorization: Basic <credential string>'
chevron-rightExample Responsehashtag
{
    "subreddit": {
        "id": "t5_2qq6z",
        "icon": "https://styles.redditmedia.com/t5_2qq6z/styles/communityIcon_xa6tgnlkeh281.png?width=64&height=64&frame=1&auto=webp&crop=64:64,smart&s=80a18d486bb54c4bbb87a55b510d80d8acf844c6",
        "widgets": [
            {
                "type": "ImageWidget",
                "id": "widget_182hhp9v2ftbl",
                "shortName": "hmmm",
                "imageUrl": "https://styles.redditmedia.com/t5_2qq6z/styles/image_widget_goltp08gay9a1.png",
                "linkUrl": "https://i.imgur.com/fgOBnTY.png"
            },
            {
                "type": "TextAreaWidget",
                "id": "widget_182hiluxajfeb",
                "shortName": "Rule details",
                "markdown": "* [Why did my post get removed?](https://www.reddit.com/r/hmmm/wiki/moderation_faq)\n\n* [Detailed Rules + Subreddit FAQ](https://www.reddit.com/r/hmmm/wiki/rules)",
                "preview": "Why did my post get removed? Detailed Rules + Subreddit FAQ"
            },
            {
                "type": "TextAreaWidget",
                "id": "widget_182hiygodnhtv",
                "shortName": "guide to a good hmmm",
                "markdown": "**hmmms** are textless images that make you think about the context, do a double take, invoke a deeper meaning, or just leave you thinking about how or why they exist:\n\n- [bizarre **hmmm**](http://i.imgur.com/WORLtGl.jpg)\n- [humour **hmmm**](http://i.imgur.com/P5PLlvA.jpg)\n- [arresting **hmmm**](https://i.imgur.com/vjTWeOw.jpg)\n- [beautiful **hmmm**](https://i.imgur.com/eGXfj03.png)\n- [confusing **hmmm**](https://i.imgur.com/yOysToi.jpg)\n- [mystery **hmmm**](https://i.imgur.com/s81FiO1.jpg)\n\nAs long as they give you a good solid [**hmmm...**](http://i.imgur.com/Zv8OoCi.jpg) why would that bear be in a cubicle...\n\n**hmmms** should be aesthetic and meaningful, avoid anything that is merely r/mildlyinteresting.",
                "preview": "hmmms are textless images that make you think about the context, do a double take, invoke a deeper meaning, or just leave you thinking about how or why they exist: bizarre hmmm humour hmmm arresting hmmm beautiful hmmm confusing hmmm mystery hmmm As long as they give you a good solid hmmm... why wou"
            },
            {
                "type": "CommunityListWidget",
                "id": "widget_182hk48fa86o1",
                "shortName": "friends",
                "communities": [
                    {
                        "name": "youtube_funeral",
                        "type": "PUBLIC",
                        "subscribersCount": 18234,
                        "icon": "https://styles.redditmedia.com/t5_24m73c/styles/communityIcon_rla7es2mxgp31.png?width=64&height=64&frame=1&auto=webp&crop=64:64,smart&s=62517a5284edaca898f7009f67bf3f89cfe2df0b"
                    },
                    {
                        "name": "internet_funeral",
                        "type": "PUBLIC",
                        "subscribersCount": 101241,
                        "icon": "https://styles.redditmedia.com/t5_z0qc5/styles/communityIcon_6g80h3ywbfp21.jpg?width=64&height=64&frame=1&auto=webp&crop=64:64,smart&s=675cf3a1a04539314c87196341c07cc9a0ccf6cc"
                    },
                    {
                        "name": "lowrescrops",
                        "type": "PUBLIC",
                        "subscribersCount": 1287,
                        "icon": "https://styles.redditmedia.com/t5_10kfdx/styles/communityIcon_a8oc9r5frfu31.png?width=64&height=64&frame=1&auto=webp&crop=64:64,smart&s=a6beced526bf03d69a90c97fc35dba09f0c4caa7"
                    },
                    {
                        "name": "hmmmgifs",
                        "type": "PUBLIC",
                        "subscribersCount": 209370,
                        "icon": "https://styles.redditmedia.com/t5_3erhn/styles/communityIcon_65ywl97rp1b61.png?width=64&height=64&frame=1&auto=webp&crop=64:64,smart&s=3be44ccc0d8d212eb5d4a6820ba5bfc7685f99b4"
                    },
                    {
                        "name": "internetcollection",
                        "type": "RESTRICTED",
                        "subscribersCount": 3961,
                        "icon": null
                    },
                    {
                        "name": "wholesomememes",
                        "type": "PUBLIC",
                        "subscribersCount": 18234404,
                        "icon": null
                    },
                    {
                        "name": "MemeEconomy",
                        "type": "PUBLIC",
                        "subscribersCount": 1853100,
                        "icon": "https://styles.redditmedia.com/t5_3gl3k/styles/communityIcon_uehedmrk7yzf1.jpg?width=64&height=64&frame=1&auto=webp&crop=64:64,smart&s=d128d82e8697c8ffb71717f699758e2ad4a3af05"
                    }
                ]
            }
        ],
        "moderators": [
            "t2_8anq9",
            "t2_9pz6h",
            "t2_j0ep6",
            "t2_ahl1l",
            "t2_9c1zf",
            "t2_6v1ae",
            "t2_y15nr",
            "t2_7ia9h",
            "t2_6k0yt",
            "t2_4vggm",
            "t2_d86cgxu",
            "t2_rvb63",
            "t2_15ahgc7f",
            "t2_9r2awai",
            "t2_24ighvv",
            "t2_o25o3",
            "t2_81vyw",
            "t2_3tzmlbil",
            "t2_12fi051x",
            "t2_1ehsge4a"
        ],
        "rules": [
            {
                "name": "No text in the image (except normal logos)",
                "violationReason": "No text (except normal logos)",
                "text": "See [here](https://www.reddit.com/r/hmmm/wiki/rules#wiki_1._no_text) for the details of this rule and examples/exceptions.\n\n- The main exception is normal logos and any normal, non-distracting packaging text. Not including abnormal logos or simple jokes/plays on the words in logos.\n\n- Numbers, individual characters, non-english text, and [very minor incidental text](https://imgur.com/a/oiBk1cb), truncated/hard to read text can be acceptable if they are not the hmmm/not distracting from the hmmm."
            },
            {
                "name": "All titles must be \"hmmm\" (in lowercase)",
                "violationReason": "All titles must be \"hmmm\" (in lowercase)",
                "text": ""
            },
            {
                "name": "No explicit pornography, gore, or gross-out images",
                "violationReason": "No explicit pornography, gore, or gross-out images",
                "text": "Details: No sexualized or explicit genitals, excrement, animal cruelty/suffering/graphic death, gore, or body modification/messed up body/disease/disability posts.\n\nThis also includes pictures where there is any indecency or any possible interpretation of sexualization of a minor.\n\nNudity/NSFW posts are allowed but images should contain [artistic value](http://i.imgur.com/14N8k23.jpg)."
            },
            {
                "name": "Gifs should be posted to /r/hmmmgifs",
                "violationReason": "Gifs should be posted to /r/hmmmgifs",
                "text": ""
            },
            {
                "name": "No memes, mashups or drawings",
                "violationReason": "No memes, mashups or drawings",
                "text": "* [Meme definition](https://www.reddit.com/r/hmmm/wiki/rules#wiki_memes)\n\n* [Mashup definition](https://www.reddit.com/r/hmmm/wiki/rules#wiki_mashups) (e.g. faceswaps)\n\n* [Drawings definition](https://www.reddit.com/r/hmmm/wiki/rules#wiki_drawings)\n\n* [See our AI policy regarding AI images](https://www.reddit.com/r/hmmm/wiki/rules#wiki_ai_generated_art)"
            },
            {
                "name": "Use imgur/reddit for hosting",
                "violationReason": "Use imgur/reddit for hosting",
                "text": ""
            },
            {
                "name": "Submit high quality and cropped images",
                "violationReason": "Submit high quality and cropped images",
                "text": "* [Quality guidelines](https://www.reddit.com/r/hmmm/wiki/rules#wiki_7._submit_high_quality_and_cropped_images) \n\n* [Cropping guidelines](https://www.reddit.com/r/hmmm/wiki/rules#wiki_cropping)\n"
            },
            {
                "name": "Looks-like images",
                "violationReason": "Looks-like images",
                "text": "[Click here for full details about which images get removed.](https://www.reddit.com/r/hmmm/wiki/rules#wiki_8._looks-like_images)\n\nMajor categories:\n\n* [Confusing perspective](https://i.imgur.com/m7TCRLd) / [coincidental lineups](https://i.imgur.com/3FSQEt6.png)\n* Looks like a dick/sex act\n* Looks like a face\n* Multi-panel [things or characters that look like each other](https://imgur.com/a/OWnJx0K), or [scene mashups](https://imgur.com/a/vGJUKna) when pictures individually are not hmmm."
            }
        ]
    }
}

Subreddit Posts

Description

List posts within a subreddit, supporting sort and range filters. Returns engagement stats per post and media previews.

Endpoint

GET api/v1/realtime/social/reddit/v1/subreddit/{name}/posts

Parameters

Param
Required
Param Type
Description

query

Yes

Path Param

String | The comment id

cursor

No

Query Param

String | The cursor to the next page of posts

sort

No Default: BEST

Query Param

String | The sort order. Available values: BEST, NEW, TOP, HOT, CONTROVERSIAL, RISING

range

No Default: ALL_TIME

Query Param

String | The time range (required when sort is TOP or CONTROVERSIAL) Available values: PAST_HOUR, TODAY, PAST_WEEK, PAST_MONTH, PAST_YEAR, ALL_TIME

Pagination

  • results per page: 0-30

  • max results per query: ~285

  • cursor path in the response: pageInfo.cursor

  • If pageInfo.cursor is null, there are no additional pages available

circle-info

Note: Second page sometimes contains a posts from the first response.

chevron-rightExample Requesthashtag
chevron-rightExample Responsehashtag

Subreddit Wiki Page

Description

Retrieve the wiki page for a specific subreddit, including markdown content and revision information.

Endpoint

GET api/v1/realtime/social/reddit/v1/subreddit/{name}/wiki

Parameters

Param
Required
Param Type
Description

name

Yes

Path Param

String | The subreddit name

chevron-rightExample Requesthashtag
chevron-rightExample Responsehashtag

Last updated