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

# Get Community Details

> Get detailed information about a Twitter community. Returns comprehensive community data including name, description, member count, join policy, banner image, creator/admin info, and community rules. Useful for understanding a community before exploring its content.



## OpenAPI

````yaml get /v1/twitter/communities/{community_id}
openapi: 3.1.0
info:
  title: ScrapeBadger Twitter API
  description: >-
    The ScrapeBadger Twitter API provides programmatic access to Twitter/X data
    through a simple REST interface. Retrieve tweets, user profiles, followers,
    lists, communities, trends, and geographic data — all with a single API key.


    All endpoints require authentication via the `x-api-key` header. Each
    request consumes credits from your account balance. Paginated endpoints
    return a `next_cursor` field that you can pass to subsequent requests to
    retrieve additional pages of results.


    **Base URL:** `https://scrapebadger.com/v1/twitter`


    **Rate Limits:** Requests are rate-limited per API key. If you exceed your
    limit, you will receive a `429` response. Implement exponential backoff and
    retry logic for production use.


    **Credits:** Each successful API call deducts credits from your balance. If
    your balance reaches zero, subsequent requests will return `402 Payment
    Required`.
  version: 1.0.0
  contact:
    name: ScrapeBadger Support
    url: https://scrapebadger.com
    email: support@scrapebadger.com
servers:
  - url: https://scrapebadger.com
    description: Production
security:
  - apiKey: []
tags:
  - name: Tweets
    description: >-
      Retrieve tweets, search tweets, and access tweet metadata including
      replies, quotes, retweeters, favoriters, edit history, and community
      notes.
  - name: Users
    description: >-
      Retrieve user profiles, followers, following lists, mentions,
      subscriptions, and search for users.
  - name: Lists
    description: Access Twitter list details, list tweets, and search within lists.
  - name: Communities
    description: Retrieve community details, community tweets, and search for communities.
  - name: Trends
    description: Get trending topics globally or by location.
  - name: Geo
    description: Search for geographic places and retrieve place details.
  - name: Spaces
    description: Access Twitter Spaces and live broadcast details.
  - name: Stream Monitors
    description: >-
      Create and manage real-time stream monitors that track Twitter accounts
      and deliver new tweets via WebSocket or webhook.
  - name: Stream Webhooks
    description: >-
      Manage webhook endpoints for stream monitor delivery. Webhooks receive
      HMAC-SHA256 signed payloads when new tweets are detected.
  - name: Stream Logs
    description: >-
      Access delivery logs and billing logs for stream monitors. Track tweet
      detection latency, webhook delivery status, and credit consumption.
  - name: Filter Rules
    description: >-
      Create and manage filter rules that monitor Twitter using Advanced Search
      queries at configurable intervals. Delivered via WebSocket or webhook.
paths:
  /v1/twitter/communities/{community_id}:
    get:
      tags:
        - Communities
      summary: Get community details
      description: >-
        Get detailed information about a Twitter community. Returns
        comprehensive community data including name, description, member count,
        join policy, banner image, creator/admin info, and community rules.
        Useful for understanding a community before exploring its content.
      operationId: getCommunityDetail
      parameters:
        - name: community_id
          in: path
          required: true
          description: The unique numeric ID of the community.
          schema:
            type: string
            example: '1234567890'
      responses:
        '200':
          description: Successfully retrieved community details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommunityData'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '429':
          $ref: '#/components/responses/RateLimitExceeded'
components:
  schemas:
    CommunityData:
      type: object
      description: Comprehensive Twitter community data.
      required:
        - id
        - name
      properties:
        id:
          type: string
          description: Unique community identifier.
          example: '1234567890'
        name:
          type: string
          description: Name of the community.
          example: Web Developers
        description:
          type:
            - string
            - 'null'
          description: Description of the community.
        member_count:
          type:
            - integer
            - 'null'
          description: Number of members.
        is_member:
          type:
            - boolean
            - 'null'
          description: Whether the authenticated user is a member.
        role:
          type:
            - string
            - 'null'
          description: Role of the authenticated user.
          enum:
            - member
            - moderator
            - admin
            - non_member
        is_nsfw:
          type:
            - boolean
            - 'null'
          description: Whether the community is marked as NSFW.
        join_policy:
          type:
            - string
            - 'null'
          description: Join policy for the community.
          enum:
            - Open
            - Closed
        invites_policy:
          type:
            - string
            - 'null'
          description: Invites policy for the community.
        created_at:
          type:
            - integer
            - 'null'
          description: Creation timestamp in milliseconds.
        created_at_datetime:
          type:
            - string
            - 'null'
          description: Creation date in ISO 8601 format.
        banner:
          oneOf:
            - $ref: '#/components/schemas/CommunityBanner'
            - type: 'null'
          description: Community banner image.
        creator_id:
          type:
            - string
            - 'null'
          description: Numeric ID of the community creator.
        creator_username:
          type:
            - string
            - 'null'
          description: Username of the community creator.
        creator_name:
          type:
            - string
            - 'null'
          description: Display name of the community creator.
        admin_id:
          type:
            - string
            - 'null'
          description: Numeric ID of the community admin.
        admin_username:
          type:
            - string
            - 'null'
          description: Username of the community admin.
        admin_name:
          type:
            - string
            - 'null'
          description: Display name of the community admin.
        rules:
          type:
            - array
            - 'null'
          description: Community rules.
          items:
            $ref: '#/components/schemas/CommunityRule'
    CommunityBanner:
      type: object
      description: Community banner image information.
      properties:
        url:
          type:
            - string
            - 'null'
          description: URL of the banner image.
        width:
          type:
            - integer
            - 'null'
          description: Width of the banner in pixels.
        height:
          type:
            - integer
            - 'null'
          description: Height of the banner in pixels.
    CommunityRule:
      type: object
      description: A community rule.
      properties:
        name:
          type:
            - string
            - 'null'
          description: Name/title of the rule.
        description:
          type:
            - string
            - 'null'
          description: Detailed description of the rule.
    ErrorResponse:
      type: object
      description: Error response returned for failed requests.
      required:
        - error
      properties:
        error:
          type: string
          description: Human-readable error message describing what went wrong.
  responses:
    Unauthorized:
      description: Authentication failed. The API key is missing, invalid, or expired.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error: Invalid or missing API key
    PaymentRequired:
      description: >-
        Insufficient credits. Your account balance has been exhausted. Purchase
        more credits at https://scrapebadger.com/dashboard/billing.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error: Insufficient credits
    RateLimitExceeded:
      description: >-
        Rate limit exceeded. Too many requests in a given time period. Implement
        exponential backoff and retry.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error: Rate limit exceeded. Please retry after a short delay.
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header
      description: >-
        Your ScrapeBadger API key. You can find this in your dashboard at
        https://scrapebadger.com/dashboard/api-keys.

````