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

# Search Communities

> Searches for Twitter/X communities by query. Returns id, name, banner_url and member_count for each result, plus next_cursor for pagination. banner_url uses the default banner when no custom banner exists. Empty results are returned as an empty communities array.



## OpenAPI

````yaml https://api.sorsa.io/v3/swagger.json post /search-communities
openapi: 3.0.3
info:
  contact: {}
  title: API Sorsa.io
  version: '3.0'
servers:
  - url: https://api.sorsa.io/v3
security: []
paths:
  /search-communities:
    post:
      tags:
        - Community
      summary: Search Communities
      description: >-
        Searches for Twitter/X communities by query. Returns id, name,
        banner_url and member_count for each result, plus next_cursor for
        pagination. banner_url uses the default banner when no custom banner
        exists. Empty results are returned as an empty communities array.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/community.SearchCommunitiesReq'
        description: query required, next_cursor optional
        required: true
        x-originalParamName: payload
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/common.CommunitiesResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Unauthorized
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Payment Required
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Forbidden
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Too Many Requests
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Internal Server Error
      security:
        - ApiKeyAuth: []
components:
  schemas:
    community.SearchCommunitiesReq:
      properties:
        next_cursor:
          description: Optional pagination cursor from the previous response.
          example: WzIuNjAyMDYsMTkzOTQ5NzMxMjY2MzA4MTMzNV0=
          type: string
        query:
          description: Search query. Required.
          example: IBT
          type: string
      required:
        - query
      type: object
    common.CommunitiesResponse:
      properties:
        communities:
          description: Matching communities. Empty array when there are no results.
          items:
            $ref: '#/components/schemas/common.Community'
          type: array
        next_cursor:
          description: Cursor for the next page. Empty when no further page is available.
          type: string
      type: object
    handler.ErrorResponse:
      properties:
        message:
          type: string
      type: object
    common.Community:
      properties:
        banner_url:
          description: Custom banner URL, or the default banner if no custom banner exists.
          type: string
        id:
          description: Numeric community ID.
          example: '1966045657589813686'
          type: string
        member_count:
          example: 74
          type: integer
        name:
          example: IBT
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: ApiKey
      type: apiKey

````