Posts

Posts info by ID

Description

Fetch information for one or more posts by their IDs. Returns an array of post details including metadata, author information and media.

Endpoint

POST api/v1/realtime/social/reddit/v1/posts/info

Parameters

Param	Required	Param Type	Description
ids	Yes	Body Param	List | Array of post IDs to fetch information. All posts ids must start with 't3_'. Maximum 100 ids per request

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/social/reddit/v1/posts/info' \
--header 'Authorization: Basic <credential string>'
--data '{
    "ids": [
        "t3_1nw84pp"
    ]
}'

Example Response

[
    {
        "id": "t3_1nw84pp",
        "title": "Anyone else?",
        "type": "SubredditPost",
        "createdAt": "2025-10-02T16:13:08.150Z",
        "editedAt": null,
        "upvote": 36,
        "url": "https://i.redd.it/629fpozo3qsf1.jpeg",
        "content": null,
        "commentCount": 59,
        "upvoteRatio": 0.9090909090909091,
        "author": {
            "type": "user",
            "id": "t2_oqje3tyg",
            "name": "LoganWX01",
            "icon": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_0.png"
        },
        "thumbnail": "https://b.thumbs.redditmedia.com/DjxVX5ild1ludJsr__zTD5ffPmGfetbQKojQpvheioA.jpg",
        "media": {
            "preview": "https://preview.redd.it/629fpozo3qsf1.jpeg?auto=webp&s=7b79934c7bb504cf02261b42c39958db5cd6de30",
            "type": "IMAGE",
            "video": null
        },
        "permalink": "/r/blackops7/comments/1nw84pp/anyone_else/",
        "gallery": null,
        "poll": null,
        "flair": "Feedback",
        "crosspostRoot": null,
        "removedByCategory": null,
        "subreddit": {
            "id": "t5_bejg0d",
            "name": "blackops7",
            "prefixedName": "r/blackops7",
            "title": "Black Ops 7",
            "subscribersCount": 20402,
            "icon": "https://styles.redditmedia.com/t5_bejg0d/styles/communityIcon_cqaqqhg0qp5f1.jpeg?width=64&height=64&frame=1&auto=webp&crop=64:64,smart&s=80e5dcfc02ad3fe5b6c615db1dc4c3c04484cf1f",
            "banner": "https://styles.redditmedia.com/t5_bejg0d/styles/bannerBackgroundImage_mjmrk4xxpp5f1.jpeg?format=pjpg&s=4a5699c21779f0ae4fa527b01b770cc1db4be7a9"
        }
    }
]

---

Posts Discussion

Description

Fetch the full discussion tree for a post. Returns nested comments sorted by order (best, top, new, etc.), up to a maximum depth of 10. Useful for analyzing conversation structure or engagement.

Endpoint

GET api/v1/realtime/social/reddit/v1/posts/{postId}/discussion

Parameters

Param	Required	Param Type	Description
postId	Yes	Path Param	String | The post id
cursor	No	Query Param	Sting | The pagination cursor
sort	No Default: NEW	Query Param	Sting | The sort order. Available values: BEST, NEW, TOP, CONTROVERSIAL, OLD, QA

Pagination

Pagination in this endpoint works as a tree-based structure

• Results per page: 0-200

• Each comment in the comments array includes a depth field that indicates its nesting level in the tree. The maximum supported comment tree depth is 10.

• The $comment.more.cursor field provides the cursor for fetching the next page of comments at that specific depth and branch

• The main cursor path in the response: pageInfo.cursor

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

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/reddit/v1/posts/t3_1nh5ggx/discussion' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "post": {
        "id": "t3_1nh5ggx",
        "title": "May the best game win ✨",
        "type": "SubredditPost",
        "subreddit": {
            "id": "t5_2qhzy",
            "name": "videogames",
            "prefixedName": "r/videogames"
        },
        "pageInfo": {
            "hasNextPage": true,
            "cursor": "eyJxdWVyeUlkI...."
        },
        "commentCount": 1043,
        "comments": [
            {
                "parentId": null,
                "depth": 0,
                "type": "Comment",
                "id": "t1_nfhqtxu",
                "content": "Get death stranding 2 outa here",
                "richtextMedia": [],
                "createdAt": "2025-09-21T21:24:09.727Z",
                "editedAt": null,
                "upvotes": 1,
                "author": {
                    "type": "user",
                    "id": "t2_i073jt6bw",
                    "name": "Unique-Reach1754",
                    "icon": "https://styles.redditmedia.com/t5_959lv3/styles/profileIcon_snoo-nftv2_bmZ0X2VpcDE1NToxMzdfZWI5NTlhNzE1ZGZmZmU2ZjgyZjQ2MDU1MzM5ODJjNDg1OWNiMTRmZV8xMzk0ODA4OA_rare_77dbfabb-c9c6-4f5c-844e-a58c5330486c-headshot.png?width=50&height=50&frame=1&auto=webp&crop=50%3A50%2Csmart&s=e1bf6a5fdcfea76ce6d0315f1759f04eb2882855"
                },
                "permalink": "/r/videogames/comments/1nh5ggx/may_the_best_game_win/nfhqtxu/",
                "more": null
            },
            {
                "parentId": null,
                "depth": 0,
                "type": "Comment",
                "id": "t1_nfcxaq0",
                "content": "Get Ghost out of here. It won't matter how good it is, it's already seeped in controversy. And we know games that have controversy attached to them don't win game of the year.  Except for one that won somehow, and we all know the one I'm talking about.",
                "richtextMedia": [],
                "createdAt": "2025-09-21T03:15:07.769Z",
                "editedAt": null,
                "upvotes": 1,
                "author": {
                    "type": "user",
                    "id": "t2_7b0dwyig",
                    "name": "BlackZorlite",
                    "icon": "https://styles.redditmedia.com/t5_2zl6wv/styles/profileIcon_snoo-nftv2_bmZ0X2VpcDE1NToxMzdfNDY2YTMzMDg4N2JkZjYyZDUzZjk2OGVhODI0NzkzMTUwZjA3NzYyZV8xMTY2NTA3_rare_774f51aa-2318-43d3-a2c5-1f6869b64726-headshot.png?width=50&height=50&frame=1&auto=webp&crop=50%3A50%2Csmart&s=3218061600b7d03666f01a4913b38c40d27030ba"
                },
                "permalink": "/r/videogames/comments/1nh5ggx/may_the_best_game_win/nfcxaq0/",
                "more": null
            },
            {
                "parentId": null,
                "depth": 0,
                "type": "Comment",
                "id": "t1_nfb7079",
                "content": "Replace Ghost of Yotei with Donkey Kong Country Returns and I think that’s a great list. Knowing Geoff and how each game awards goes, Elden Ring Nightrein will be on there for whatever reason. Not a bad game just not game of the year imo",
                "richtextMedia": [],
                "createdAt": "2025-09-20T20:56:27.180Z",
                "editedAt": null,
                "upvotes": 1,
                "author": {
                    "type": "user",
                    "id": "t2_eifx3mmd",
                    "name": "Turbulent_Help771",
                    "icon": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_5.png"
                },
                "permalink": "/r/videogames/comments/1nh5ggx/may_the_best_game_win/nfb7079/",
                "more": null
            },
           ...
        ]
    }
}

---