Reddit

Get Reddit post comments

Returns a Reddit post with its public comments. The default mode is 1 credit. Set include_metrics=true to return the comments with public net score and award count plus post engagement metrics for 3 credits. Large threads may expose only an initial comment subset. Reddit does not expose per-comment upvote ratios or exact upvote/downvote totals anonymously. A post that exists but has no comments yet returns a 200 response with an empty comments list; a post that does not exist returns 404, and a temporary block or upstream failure returns 503 (retryable) rather than 404. If source.type is redlib, public fields and credit weights are preserved.

get/reddit/comments/{id}

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/reddit/comments/{id}
  • Auth: API key in header x-api-key

Path parameters

idstring required

Reddit post id or t3_ id

Query parameters

sort'confidence' | 'top' | 'new' | 'controversial' | 'old' | 'qa'

Comment order: confidence, top, new, controversial, old, or qa. Applied to the anonymous HTML request when metrics are enabled.

limitinteger

Maximum comments returned, defaults to 25 and clamps to 100

depthinteger

Maximum flat comment depth returned in metrics mode.

include_metricsboolean

Include public post and per-comment engagement metrics; costs 3 credits instead of 1

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "comments": [
      {
        "author": {
          "name": "reddit_user",
          "profile_url": "https://www.reddit.com/user/reddit_user/"
        },
        "body": "I agree with this post.",
        "created": "2024-04-19T00:00:00Z",
        "created_utc": 1713484800,
        "depth": 1,
        "id": "kabc123",
        "name": "t1_kabc123",
        "parent_id": "t3_1abcxyz",
        "permalink": "https://www.reddit.com/r/OpenAI/comments/1abcxyz/openai_discussion_thread/kabc123/"
      }
    ],
    "metrics_source": {
      "type": "rss",
      "url": "https://www.reddit.com/r/OpenAI/.rss"
    },
    "post": {
      "author": {
        "name": "reddit_user",
        "profile_url": "https://www.reddit.com/user/reddit_user/"
      },
      "created": "2024-04-19T00:00:00Z",
      "created_utc": 1713484800,
      "domain": "self.OpenAI",
      "flair": "Discussion",
      "id": "1abcxyz",
      "name": "t3_1abcxyz",
      "permalink": "https://www.reddit.com/r/OpenAI/comments/1abcxyz/openai_discussion_thread/",
      "selftext": "Discussion body",
      "source_feed_url": "https://www.reddit.com/r/OpenAI/.rss",
      "subreddit": "OpenAI",
      "thumbnail": "https://b.thumbs.redditmedia.com/example.jpg",
      "title": "OpenAI discussion thread",
      "url": "https://www.reddit.com/r/OpenAI/comments/1abcxyz/openai_discussion_thread/"
    },
    "source": {
      "type": "rss",
      "url": "https://www.reddit.com/r/OpenAI/.rss"
    }
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.