Search APIs
Loading…
← API Store
Social

Reddit

Reddit

Subreddit details and rules

GET /reddit/v1/subreddit/details
Test this endpoint

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
subredditrequiredstring Example: programming

Every endpoint also takes: raw、fields、fresh、output、records

{
  "banner": null,
  "bookmarks": [
    {
      "name": "FAQ",
      "url": "https://www.reddit.com/r/programming/wiki/faq"
    }
  ],
  "cached": false,
  "created_at": "2006-02-28T18:19:29.538000+0000",
  "credits_used": 1,
  "description": "Computer Programming",
  "header_attributes": {
    "activity-indicators-enabled": true,
    "class": "nd:flex nd:visible [&:not(:defined)_.community-details]:hidden",
    "description": "Computer Programming",
    "display-name": "programming",
    "id-card-widget-id": "widget_id-card-2fwo",
    "is-mod-insights-widget-experiment-enabled": true,
    "name": "programming",
    "new-banner-experiment-enabled": true,
    "prefixed-name": "r/programming",
    "record-perfmark": "true",
    "router-name": "subreddit",
    "subreddit-id": "t5_2fwo",
    "weekly-active-users": "210980",
    "weekly-contributions": "2023"
  },
  "icon": "https://styles.redditmedia.com/t5_2fwo/styles/communityIcon_1bqa1ibfp8q11.png?width=128&frame=1&auto=webp&s=400b33e7080aa4996c405a96b3872a12…",
  "id": "t5_2fwo",
  "id_card_widget_id": "widget_id-card-2fwo",
  "name": "programming",
  "nsfw": false,
  "post_flairs_seen": [],
  "posts": [
    {
      "archived": false,
      "attributes": {
        "author": "random8847",
        "author-id": "t2_15ookh",
        "award-count": "0",
        "class": "block relative cursor-pointer group bg-neutral-background focus-within:bg-neutral-background-hover hover:bg-neutral-background-hover xs:roun…",
        "comment-count": "96",
        "content-href": "https://www.bseindia.com/xml-data/corpfiling/AttachLive/82503e00-335c-49dc-b022-f4633a08b642.pdf",
        "created-timestamp": "2026-10-23T09:55:46.598000+0000",
        "data-expected-lcp": true,
        "data-ks-item": true,
        "domain": "bseindia.com",
        "feedIndex": "0",
        "hide-awards-button": true,
        "icon": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_1.png",
        "id": "t3_1xd9rwe",
        "is-awardable": true,
        "is-desktop-viewport": true,
        "is-embeddable": true,
        "is-link-post": true,
        "is-slim-card": true,
        "moderation-verdict": "",
        "pdp-target": "_self",
        "permalink": "/r/programming/comments/1xd9rwe/emudhras_press_release_on_the_ca_compromise/",
        "post-language": "en",
        "post-title": "eMudhra's Press Release on the CA Compromise",
        "post-type": "link",
        "score": "240",
        "subreddit-id": "t5_2fwo",
        "subreddit-name": "programming",
        "subreddit-prefixed-name": "r/programming",
        "upvote-ratio": "0.9347826086956522",
        "view-context": "SubredditFeed",
        "view-type": "cardView"
      },
      "author": "random8847",
      "author_icon": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_1.png",
      "author_id": "t2_15ookh",
      "author_profile": null,
      "award_count": 0,
      "comment_count": 96,
      "comments": "96",
      "content_url": "https://www.bseindia.com/xml-data/corpfiling/AttachLive/82503e00-335c-49dc-b022-f4633a08b642.pdf",
      "created_at": "2026-10-23T09:55:46.598000+0000",
      "domain": "bseindia.com",
      "feed_index": 0,
      "flair": null,
      "flairs": [],
      "id": "t3_1xd9rwe",
      "images": [],
      "language": "en",
      "locked": false,
      "media": [],
      "nsfw": false,
      "permalink": "/r/programming/comments/1xd9rwe/emudhras_press_release_on_the_ca_compromise/",
      "post_type": "link",
      "score": "240",
      "score_value": 240,
      "spoiler": false,
      "stickied": false,
      "subreddit": "programming",
      "subreddit_id": "t5_2fwo",
      "subreddit_prefixed": "r/programming",
      "text": null,
      "text_html": null,
      "title": "eMudhra's Press Release on the CA Compromise",
      "upvote_ratio": 0.9347826086956522,
      "url": "https://www.reddit.com/r/programming/comments/1xd9rwe/emudhras_press_release_on_the_ca_compromise/"
    },
    {
      "archived": false,
      "attributes": {
        "author": "mareek",
        "author-id": "t2_3c9g",
        "award-count": "1",
        "award-icon-url": "https://i.redd.it/snoovatar/snoo_assets/marketing/regret_40.png",
        "award-id": "award_free_regret_2",
        "class": "block relative cursor-pointer group bg-neutral-background focus-within:bg-neutral-background-hover hover:bg-neutral-background-hover xs:roun…",
        "comment-count": "119",
        "content-href": "https://news.mit.edu/2026/margaret-hamilton-computing-pioneer-dies-1007",
        "created-timestamp": "2026-10-08T05:55:59.002000+0000",
        "data-expected-lcp": true,
        "data-ks-item": true,
        "domain": "news.mit.edu",
        "feedIndex": "1",
        "hide-awards-button": true,
        "icon": "https://styles.redditmedia.com/t5_dss29/styles/profileIcon_snoo0235b7cc-8c31-42bf-b2f1-1c6dcea0ceee-headshot.png?width=64&height=64&frame=1&…",
        "id": "t3_1x0j559",
        "is-awardable": true,
        "is-desktop-viewport": true,
        "is-embeddable": true,
        "is-link-post": true,
        "is-slim-card": true,
        "moderation-verdict": "",
        "pdp-target": "_self",
        "permalink": "/r/programming/comments/1x0j559/margaret_hamilton_computing_pioneer_who_led/",
        "post-language": "en",
        "post-title": "Margaret Hamilton, computing pioneer who led software development for the Apollo program, dies at 90",
        "post-type": "link",
        "score": "3839",
        "subreddit-id": "t5_2fwo",
        "subreddit-name": "programming",
        "subreddit-prefixed-name": "r/programming",
        "upvote-ratio": "0.9856447064855165",
        "view-context": "SubredditFeed",
        "view-type": "cardView"
      },
      "author": "mareek",
      "author_icon": "https://styles.redditmedia.com/t5_dss29/styles/profileIcon_snoo0235b7cc-8c31-42bf-b2f1-1c6dcea0ceee-headshot.png?width=64&height=64&frame=1&…",
      "author_id": "t2_3c9g",
      "author_profile": null,
      "award_count": 1,
      "comment_count": 119,
      "comments": "119",
      "content_url": "https://news.mit.edu/2026/margaret-hamilton-computing-pioneer-dies-1007",
      "created_at": "2026-10-08T05:55:59.002000+0000",
      "domain": "news.mit.edu",
      "feed_index": 1,
      "flair": null,
      "flairs": [],
      "id": "t3_1x0j559",
      "images": [],
      "language": "en",
      "locked": false,
      "media": [],
      "nsfw": false,
      "permalink": "/r/programming/comments/1x0j559/margaret_hamilton_computing_pioneer_who_led/",
      "post_type": "link",
      "score": "3839",
      "score_value": 3839,
      "spoiler": false,
      "stickied": false,
      "subreddit": "programming",
      "subreddit_id": "t5_2fwo",
      "subreddit_prefixed": "r/programming",
      "text": null,
      "text_html": null,
      "title": "Margaret Hamilton, computing pioneer who led software development for the Apollo program, dies at 90",
      "upvote_ratio": 0.9856447064855164,
      "url": "https://www.reddit.com/r/programming/comments/1x0j559/margaret_hamilton_computing_pioneer_who_led/"
    },
    "… 1 more"
  ],
  "posts_count": 3,
  "prefixed_name": "r/programming",
  "privacy": "Public",
  "privacy_description": "Anyone can view, post, and comment to this community",
  "quarantined": false,
  "rules": [
    {
      "description": "If you don't want to write it, we don't want to read it. This includes the use of LLMs for translation or summarisation. Moderators reserve …",
      "number": 1,
      "title": "No LLM-Written Content"
    },
    {
      "description": "Content about LLMs and AI is generally considered off-topic unless they are deeply technical . Refer to our wiki for more details.",
      "number": 2,
      "title": "AI-related posts must comply with the AI Policy"
    },
    "… 12 more"
  ],
  "title": "programming",
  "url": "https://www.reddit.com/r/programming/",
  "weekly_contributions": 2023,
  "weekly_contributions_display": "2K",
  "weekly_visitors": 210980,
  "weekly_visitors_display": "210K"
}
Response fields (118)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.bannernull
$.bookmarksarray
$.bookmarks[]object
$.bookmarks[].namestring
$.bookmarks[].urlstring
$.cachedboolean
$.created_atstring
$.credits_usedinteger
$.descriptionstring
$.header_attributesobject
$.header_attributes.activity-indicators-enabledboolean
$.header_attributes.classstring
$.header_attributes.descriptionstring
$.header_attributes.display-namestring
$.header_attributes.id-card-widget-idstring
$.header_attributes.is-mod-insights-widget-experiment-enabledboolean
$.header_attributes.namestring
$.header_attributes.new-banner-experiment-enabledboolean
$.header_attributes.prefixed-namestring
$.header_attributes.record-perfmarkstring
$.header_attributes.router-namestring
$.header_attributes.subreddit-idstring
$.header_attributes.weekly-active-usersstring
$.header_attributes.weekly-contributionsstring
$.iconstring
$.idstring
$.id_card_widget_idstring
$.namestring
$.nsfwboolean
$.post_flairs_seenarray
$.postsarray
$.posts[]object | string
$.posts[].archivedboolean
$.posts[].attributesobject
$.posts[].attributes.authorstring
$.posts[].attributes.author-idstring
$.posts[].attributes.award-countstring
$.posts[].attributes.award-icon-urlstring
$.posts[].attributes.award-idstring
$.posts[].attributes.classstring
$.posts[].attributes.comment-countstring
$.posts[].attributes.content-hrefstring
$.posts[].attributes.created-timestampstring
$.posts[].attributes.data-expected-lcpboolean
$.posts[].attributes.data-ks-itemboolean
$.posts[].attributes.domainstring
$.posts[].attributes.feedIndexstring
$.posts[].attributes.hide-awards-buttonboolean
$.posts[].attributes.iconstring
$.posts[].attributes.idstring
$.posts[].attributes.is-awardableboolean
$.posts[].attributes.is-desktop-viewportboolean
$.posts[].attributes.is-embeddableboolean
$.posts[].attributes.is-link-postboolean
$.posts[].attributes.is-slim-cardboolean
$.posts[].attributes.moderation-verdictstring
$.posts[].attributes.pdp-targetstring
$.posts[].attributes.permalinkstring
$.posts[].attributes.post-languagestring
$.posts[].attributes.post-titlestring
$.posts[].attributes.post-typestring
$.posts[].attributes.scorestring
$.posts[].attributes.subreddit-idstring
$.posts[].attributes.subreddit-namestring
$.posts[].attributes.subreddit-prefixed-namestring
$.posts[].attributes.upvote-ratiostring
$.posts[].attributes.view-contextstring
$.posts[].attributes.view-typestring
$.posts[].authorstring
$.posts[].author_iconstring
$.posts[].author_idstring
$.posts[].author_profilenull
$.posts[].award_countinteger
$.posts[].comment_countinteger
$.posts[].commentsstring
$.posts[].content_urlstring
$.posts[].created_atstring
$.posts[].domainstring
$.posts[].feed_indexinteger
$.posts[].flairnull
$.posts[].flairsarray
$.posts[].idstring
$.posts[].imagesarray
$.posts[].languagestring
$.posts[].lockedboolean
$.posts[].mediaarray
$.posts[].nsfwboolean
$.posts[].permalinkstring
$.posts[].post_typestring
$.posts[].scorestring
$.posts[].score_valueinteger
$.posts[].spoilerboolean
$.posts[].stickiedboolean
$.posts[].subredditstring
$.posts[].subreddit_idstring
$.posts[].subreddit_prefixedstring
$.posts[].textnull
$.posts[].text_htmlnull
$.posts[].titlestring
$.posts[].upvote_rationumber
$.posts[].urlstring
$.posts_countinteger
$.prefixed_namestring
$.privacystring
$.privacy_descriptionstring
$.quarantinedboolean
$.rulesarray
$.rules[]object | string
$.rules[].descriptionstring
$.rules[].numberinteger
$.rules[].titlestring
$.titlestring
$.urlstring
$.weekly_contributionsinteger
$.weekly_contributions_displaystring
$.weekly_visitorsinteger
$.weekly_visitors_displaystring