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

# Search Clusters

> Search for trending discussion clusters using semantic and keyword matching.



## OpenAPI

````yaml /openapi.json get /clusters/search
openapi: 3.0.3
info:
  title: Membit RESTful API
  description: >-
    Learn how to use Membit's RESTful API to access real-time context. Execute
    searches and retrieve real-time social context from Membit: search trending
    clusters, fetch cluster details, and find relevant posts via simple HTTP
    endpoints.
  version: 1.0.0
servers:
  - url: https://api.membit.ai/v1/
    description: Production Server
security:
  - ApiKeyAuth: []
paths:
  /clusters/search:
    get:
      summary: Search Clusters
      description: >-
        Search for trending discussion clusters using semantic and keyword
        matching.
      operationId: searchClusters
      parameters:
        - name: q
          in: query
          required: false
          description: Search query (minimum 3 characters)
          schema:
            type: string
        - name: category
          in: query
          required: false
          description: Filter clusters by topic category
          schema:
            type: string
        - name: limit
          in: query
          description: Maximum number of clusters to return (1-50)
          schema:
            type: integer
            default: 10
            minimum: 1
            maximum: 50
        - name: format
          in: query
          description: Response format
          schema:
            type: string
            enum:
              - json
              - llm
            default: json
      responses:
        '200':
          description: Successful search
          content:
            application/json:
              schema:
                type: object
                properties:
                  clusters:
                    type: array
                    items:
                      $ref: '#/components/schemas/Cluster'
            text/plain:
              schema:
                type: string
components:
  schemas:
    Cluster:
      type: object
      properties:
        label:
          type: string
          description: Unique cluster identifier
          example: Machine Learning Study Resources
        summary:
          type: string
          description: Brief description of the cluster topic
          example: >-
            Several academic resources related to mathematics, computer science,
            and machine learning are shared...
        category:
          type: string
          description: Topic category
          example: Artificial Intelligence
        engagement_score:
          type: number
          format: float
          description: Social engagement level
          example: 4010.119762872029
        search_score:
          type: number
          format: float
          description: Relevance to search query
          example: 0.9719360841066075
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Membit-Api-Key
      description: API key for authentication.

````