Fetch Subreddit Metadata, Subscribers & Community Rules

GET/v1/subreddit/info

Query Parameters

subredditstringrequired

Example Request (cURL / Python / JavaScript)

curl "https://api.redditdataapi.io/v1/subreddit/info?subreddit=" \
  -H "x-api-key: rd_live_your_api_key"

Live Response Preview

{
  "code": 0,
  "provider": "https://redditdataapi.io",
  "status": "ok",
  "msg": "success",
  "data": {
    "subreddit": "saas",
    "display_name": "SaaS",
    "subreddit_id": "t5_2qk9v",
    "title": "Software as a Service (SaaS) Founders, Engineers & Operators",
    "public_description": "Discussions on building, scaling, and marketing B2B & B2C SaaS products.",
    "description": "Welcome to r/SaaS! Share metrics, growth playbooks, and engineering architectures.",
    "subscribers": 248900,
    "active_user_count": 615,
    "over_18": false,
    "lang": "en",
    "icon_img": "https://styles.redditmedia.com/t5_2qk9v/styles/communityIcon.png",
    "banner_img": null,
    "url": "https://www.reddit.com/r/SaaS/",
    "created_utc": 1235865600,
    "created_at": "2009-02-28T00:00:00.000Z",
    "rules": [
      {
        "short_name": "No low-effort self-promotion",
        "description": "Share actionable lessons and transparent data."
      }
    ]
  },
  "meta": {
    "request_id": "e91b2f10-81e3-4c22-9118-092f1a8b5566",
    "endpoint": "/v1/subreddit/info",
    "credits_used": 2,
    "credits_remaining": 249994,
    "cache_hit": true,
    "data_age_seconds": 12,
    "latency_ms": 14
  }
}

Response Fields

Subreddit profile metadata (2 Credits per lookup)

Field	Type	Sample / Notes
`code`	integer	Example: 0
`status`	string	Example: ok
`data`	RedditSubreddit
`meta`	ResponseMeta
`request_id`	string	UUID v4 request identifier
`endpoint`	string	Canonical /v1/* endpoint path
`credits_used`	integer	Credits deducted for this call (0 on error or empty)
`credits_remaining`	integer	Remaining credit balance on account
`cache_hit`	boolean	Whether served from L1 Redis cache
`data_age_seconds`	integer	Age of cached payload in seconds
`latency_ms`	integer	End-to-end gateway latency in milliseconds

Status Codes

200: Subreddit profile metadata (2 Credits per lookup)