> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Subreddit Details

> Get details about a subreddit. Pass a subreddit name or URL to the subreddit.

**Credit Cost:** 1 credit per request

<Note>
  💳 **1 credit** per request
</Note>


## OpenAPI

````yaml GET /v1/scrape/reddit/subreddit/details
openapi: 3.1.0
info:
  title: SociaVault API
  version: 1.0.0
  description: >-
    # SociaVault API Documentation


    The SociaVault API provides comprehensive access to social media data
    extraction across multiple platforms.


    ## Features


    - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter,
    Reddit, Threads, and more

    - **Credit-Based System**: Pay-as-you-go pricing with transparent credit
    costs

    - **High Performance**: Fast, reliable data extraction

    - **Comprehensive Data**: Detailed user profiles, videos, posts, comments,
    and analytics


    ## Authentication


    All API requests require authentication using an API key in the `X-API-Key`
    header:


    ```bash

    X-API-Key: sk_live_your_api_key_here

    ```


    Get your API key from the [SociaVault
    Dashboard](https://sociavault.com/dashboard).


    ## Credits


    Each endpoint consumes credits based on data complexity:

    - Simple requests (profiles): 1 credit

    - Complex requests (demographics): 20+ credits

    - Paginated requests: Credits per page


    Check your credit balance in the dashboard or via the API.


    ## Support


    - **Documentation**: https://docs.sociavault.com

    - **Email**: support@sociavault.com

    - **Discord**: https://discord.gg/sociavault
  contact:
    name: SociaVault Support
    email: support@sociavault.com
    url: https://sociavault.com/support
  license:
    name: Commercial
    url: https://sociavault.com/terms
servers:
  - url: https://api.sociavault.com
    description: Production API
security:
  - ApiKeyAuth: []
tags:
  - name: account
    description: Account management and credit balance
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/account
  - name: tiktok
    description: Scrape TikTok profiles, videos, and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/tiktok
  - name: tiktok-shop
    description: Everything about TikTok Shop
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/tiktok-shop
  - name: instagram
    description: Gets Instagram profiles, posts, and reels
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/instagram
  - name: youtube
    description: Scrape YouTube channels, videos, and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/youtube
  - name: linkedin
    description: Scrape LinkedIn
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/linkedin
  - name: facebook
    description: Get public Facebook profiles and posts
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebook
  - name: facebookAdLibrary
    description: Scrapes the Facebook (Meta) Ad Library
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebookAdLibrary
  - name: facebookMarketplace
    description: Search Facebook Marketplace and pull full listing details
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebookMarketplace
  - name: googleAdLibrary
    description: >-
      Scrape the Google Ad Transparency Library. *This only gets the public ads.
      Some ads you need to log in for and sadly we can't get those. Also, since
      there are so many variations, the return types might not all be 100% the
      same.
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/googleAdLibrary
  - name: linkedinAdLibrary
    description: Search the LinkedIn Ad Library
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/linkedinAdLibrary
  - name: twitter
    description: Get Twitter profiles, tweets, followers and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/twitter
  - name: reddit
    description: Scrape Reddit posts and comments
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/reddit
  - name: threads
    description: Get Threads posts
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/threads
  - name: google
    description: Scrape Google search results
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/google
paths:
  /v1/scrape/reddit/subreddit/details:
    get:
      tags:
        - reddit
      summary: Subreddit Details
      description: >-
        Get details about a subreddit. Pass a subreddit name or URL to the
        subreddit.


        **Credit Cost:** 1 credit per request
      operationId: reddit_Subreddit_Details
      parameters:
        - name: subreddit
          in: query
          description: >-
            Subreddit name. MUST be case sensitive. So 'AskReddit' not
            'askreddit'.
          required: false
          schema:
            type: string
            example: AskReddit
        - name: url
          in: query
          description: Subreddit URL
          required: false
          schema:
            type: string
            example: https://www.reddit.com/r/AbsoluteUnits/
      responses:
        '200':
          description: >-
            Successful response


            **Key Response Fields:**

            - `subreddit_id`: Unique Reddit full-name ID for the subreddit (e.g.
            `t5_a7wuv`)

            - `display_name`: The subreddit's display name (case-sensitive)

            - `subscribers`: Total subscriber count

            - `weekly_active_users`: Users active in the past week

            - `weekly_contributions`: Content contributions in the past week

            - `description`: Subreddit's public description or tagline

            - `rules`: Full rules text for the subreddit

            - `icon_img`: URL of the subreddit's community icon

            - `created_at`: ISO 8601 timestamp when the subreddit was created

            - `credits_remaining`: How many API credits remain after this
            request
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  credits_remaining:
                    type: integer
                    example: 33950256
                  subreddit_id:
                    type: string
                    example: t5_a7wuv
                  display_name:
                    type: string
                    example: AbsoluteUnits
                  weekly_active_users:
                    type: integer
                    example: 1428398
                  weekly_contributions:
                    type: integer
                    example: 8923
                  rules:
                    type: string
                    example: >-
                      #ABSOLUTE UNITS


                      ---

                          Be in awe at the size of these lads

                      ---


                      ###[Check out our deep, well-reflected definitions of an
                      absolute
                      unit.](https://www.reddit.com/r/AbsoluteUnits/wiki/index)  
                  description:
                    type: string
                    example: >-
                      Absolute Unit : an Animal or Public Figure, who is larger
                      than we should normally expect.
                  header_img:
                    type: string
                    nullable: true
                    example: null
                  icon_img:
                    type: string
                    example: >-
                      https://styles.redditmedia.com/t5_a7wuv/styles/communityIcon_t3cspt08bl681.png?width=128&frame=1&auto=webp&s=6f7e59ccf1724bd6c8b3e0d2840c9b21297102c3
                  subscribers:
                    type: integer
                    example: 1923642
                  advertiser_category:
                    type: string
                    example: ''
                  created_at:
                    type: string
                    example: '2018-01-05T10:35:24.000Z'
                  submit_text:
                    type: string
                    example: ''
                required:
                  - success
                  - subreddit_id
                  - display_name
                  - subscribers
              examples:
                full:
                  summary: Full Response
                  value:
                    success: true
                    credits_remaining: 33950256
                    subreddit_id: t5_a7wuv
                    display_name: AbsoluteUnits
                    weekly_active_users: 1428398
                    weekly_contributions: 8923
                    rules: >-
                      #ABSOLUTE UNITS


                      ---

                          Be in awe at the size of these lads

                      ---


                      ###[Check out our deep, well-reflected definitions of an
                      absolute
                      unit.](https://www.reddit.com/r/AbsoluteUnits/wiki/index)  
                    description: >-
                      Absolute Unit : an Animal or Public Figure, who is larger
                      than we should normally expect.
                    header_img: null
                    icon_img: >-
                      https://styles.redditmedia.com/t5_a7wuv/styles/communityIcon_t3cspt08bl681.png?width=128&frame=1&auto=webp&s=6f7e59ccf1724bd6c8b3e0d2840c9b21297102c3
                    subscribers: 1923642
                    advertiser_category: ''
                    created_at: '2018-01-05T10:35:24.000Z'
                    submit_text: ''
        '400':
          description: Bad Request - Invalid parameters or missing required fields
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Either subreddit name or URL is required
                  endpoint:
                    type: string
                  credits_required:
                    type: integer
                required:
                  - error
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Invalid API key
                  docs:
                    type: string
                    example: https://docs.sociavault.com/authentication
                required:
                  - error
        '402':
          description: Payment Required - Insufficient credits
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Insufficient credits
                  required:
                    type: integer
                    example: 1
                    description: Credits required for this request
                  available:
                    type: integer
                    example: 0
                    description: Credits currently available
                required:
                  - error
                  - required
                  - available
        '500':
          description: Internal Server Error - Service configuration or processing error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Service configuration error
                required:
                  - error
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: |-
        API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`

        Get your API key from the [Dashboard](https://sociavault.com/dashboard).

````