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

# search social mentions by keyword

> Searches recent social mentions (Twitter/X) for a keyword to answer
"who is talking / what are they saying / what just happened".
Output should be a list of tweets with text, author, timestamp, permalink,
engagement metrics (if available), and optional language/region info.



## OpenAPI

````yaml get /v1/tool/search-mentions
openapi: 3.1.0
info:
  description: >-
    Tops Public Tool API exposes [Tops](https://tops.chainbase.com) social
    signal data as REST endpoints,

    making crypto social intelligence accessible to any HTTP client.


    Unlike the Chainbase Web3 API (which covers on-chain data), Tops focuses
    exclusively on

    **crypto social intelligence**: trending narratives, topic discovery, and
    Twitter/X social mentions.


    No API key required — it's free to use.

    Rate limited per client IP: 10 req/s, 60 req/min, 600 req/hour.
  title: Tops Public Tool API
  version: '1.0'
servers:
  - url: https://api.chainbase.com/tops
security: []
externalDocs:
  description: ''
  url: ''
paths:
  /v1/tool/search-mentions:
    get:
      tags:
        - Tool
      summary: search social mentions by keyword
      description: >-
        Searches recent social mentions (Twitter/X) for a keyword to answer

        "who is talking / what are they saying / what just happened".

        Output should be a list of tweets with text, author, timestamp,
        permalink,

        engagement metrics (if available), and optional language/region info.
      parameters:
        - description: keyword to search Twitter/X mentions
          in: query
          name: keyword
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/pubtool.ItemsResponse-domain_Tweet'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/pubtool.ErrorResponse'
          description: Bad Request
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/pubtool.ErrorResponse'
          description: Too Many Requests
components:
  schemas:
    pubtool.ItemsResponse-domain_Tweet:
      properties:
        count:
          type: integer
        items:
          items:
            $ref: '#/components/schemas/domain.Tweet'
          type: array
          uniqueItems: false
      type: object
    pubtool.ErrorResponse:
      properties:
        error:
          type: string
      type: object
    domain.Tweet:
      properties:
        id:
          type: string
        media_json:
          type: string
        text:
          type: string
        user:
          $ref: '#/components/schemas/domain.XUser'
      type: object
    domain.XUser:
      properties:
        blue_verified:
          type: boolean
        name:
          type: string
        profile_image:
          type: string
        screen_name:
          type: string
        user_id:
          type: string
      type: object

````