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

# Mindshare Ranking



## OpenAPI

````yaml openapi.json GET /gateway/v1/social/ranking
openapi: 3.1.0
info:
  title: Hermod
  version: 0.0.1
servers:
  - url: https://api.asksurf.ai
security: []
paths:
  /gateway/v1/social/ranking:
    get:
      tags:
        - Social
      summary: Social Mindshare Ranking
      description: >-
        Returns top crypto projects ranked by mindshare (social view count),
        refreshed every 5 minutes.


        **Filters:**

        - `tag` — scope to a category (e.g. `dex`, `l1`, `meme`)

        - `time_range` — ranking window (`24h`, `48h`, `7d`, `30d`)


        Supports `limit`/`offset` pagination.
      operationId: social-ranking
      parameters:
        - description: Pagination offset
          explode: false
          in: query
          name: offset
          schema:
            default: 0
            description: Pagination offset
            examples:
              - 0
            format: int64
            minimum: 0
            type: integer
        - description: Results per page
          explode: false
          in: query
          name: limit
          schema:
            default: 20
            description: Results per page
            examples:
              - 20
            format: int64
            maximum: 100
            minimum: 1
            type: integer
        - description: >-
            Filter by project category. `l1` = Layer 1, `l2` = Layer 2/scaling,
            `dex` = DEX/AMM, `derivatives` = perps/options, `cex` = centralized
            exchange, `gamefi` = gaming, `nft` = NFT collections, `oracle` =
            oracle, `prediction` = prediction market, `rwa` = real-world assets,
            `yield` = yield/asset management, `data` = data/analytics, `devtool`
            = developer tooling, `compliance` = compliance/regtech, `meme` =
            meme/token launchpad.
          explode: false
          in: query
          name: tag
          schema:
            description: >-
              Filter by project category. `l1` = Layer 1, `l2` = Layer
              2/scaling, `dex` = DEX/AMM, `derivatives` = perps/options, `cex` =
              centralized exchange, `gamefi` = gaming, `nft` = NFT collections,
              `oracle` = oracle, `prediction` = prediction market, `rwa` =
              real-world assets, `yield` = yield/asset management, `data` =
              data/analytics, `devtool` = developer tooling, `compliance` =
              compliance/regtech, `meme` = meme/token launchpad.
            enum:
              - l1
              - l2
              - dex
              - derivatives
              - cex
              - gamefi
              - nft
              - oracle
              - prediction
              - rwa
              - yield
              - data
              - devtool
              - compliance
              - meme
              - ''
            examples:
              - dex
            type: string
        - description: Mindshare ranking timeframe window
          explode: false
          in: query
          name: time_range
          schema:
            default: 7d
            description: Mindshare ranking timeframe window
            enum:
              - 24h
              - 48h
              - 7d
              - 30d
            examples:
              - 7d
            type: string
        - description: >-
            Filter by sentiment polarity. Only projects with sufficient tweet
            data are classified.
          explode: false
          in: query
          name: sentiment
          schema:
            description: >-
              Filter by sentiment polarity. Only projects with sufficient tweet
              data are classified.
            enum:
              - positive
              - negative
              - ''
            examples:
              - positive
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponseMindshareTopProject'
          description: OK
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataAPIError'
          description: Error
      security:
        - AccessToken: []
components:
  schemas:
    DataResponseMindshareTopProject:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - https://example.com/schemas/DataResponseMindshareTopProject.json
          format: uri
          readOnly: true
          type: string
        data:
          items:
            $ref: '#/components/schemas/MindshareTopProject'
          type:
            - array
            - 'null'
        meta:
          $ref: '#/components/schemas/OffsetMeta'
      required:
        - data
        - meta
      type: object
    DataAPIError:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - https://example.com/schemas/DataAPIError.json
          format: uri
          readOnly: true
          type: string
        error:
          $ref: '#/components/schemas/DataAPIErrorDetail'
      required:
        - error
      type: object
    MindshareTopProject:
      additionalProperties: false
      properties:
        project:
          $ref: '#/components/schemas/MindshareTopProjectInfo'
          description: Project metadata
        rank:
          description: Rank position in the mindshare leaderboard
          format: int64
          type: integer
        sentiment:
          description: 'Sentiment polarity: positive or negative'
          type: string
        sentiment_score:
          description: >-
            Weighted sentiment score from -1 (very negative) to 1 (very
            positive)
          format: double
          type: number
        tags:
          description: Project category tags
          items:
            type: string
          type:
            - array
            - 'null'
        token:
          $ref: '#/components/schemas/MindshareTopTokenInfo'
          description: Token metadata
        trending_short_reason:
          description: 'Deprecated: no longer populated.'
          type: string
        trending_summary:
          description: 'Deprecated: no longer populated.'
          type: string
        twitter:
          $ref: '#/components/schemas/MindshareTopTwitterInfo'
          description: X (Twitter) account metadata
      required:
        - rank
      type: object
    OffsetMeta:
      additionalProperties: false
      properties:
        cached:
          description: Whether this response was served from cache
          type: boolean
        credits_used:
          description: Credits deducted for this request
          format: int64
          type: integer
        limit:
          description: Maximum number of items returned in this response
          format: int64
          type: integer
        offset:
          description: Number of items skipped (pagination offset)
          format: int64
          type: integer
        total:
          description: >-
            Total number of matching items (before pagination). Omitted when
            total is unknown.
          format: int64
          type: integer
      required:
        - limit
        - offset
        - credits_used
        - cached
      type: object
    DataAPIErrorDetail:
      additionalProperties: false
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
      type: object
    MindshareTopProjectInfo:
      additionalProperties: false
      properties:
        id:
          description: >-
            Surf project UUID — pass as 'id' parameter to /project/detail,
            /project/events, or /project/defi/metrics for exact lookup
          type: string
        name:
          description: Project name
          type: string
        slug:
          description: URL-friendly project slug
          type: string
      required:
        - id
        - name
      type: object
    MindshareTopTokenInfo:
      additionalProperties: false
      properties:
        id:
          description: Surf token UUID
          type: string
        image:
          description: Token image URL
          type: string
        name:
          description: Token name
          type: string
        symbol:
          description: Token ticker symbol
          type: string
      required:
        - name
      type: object
    MindshareTopTwitterInfo:
      additionalProperties: false
      properties:
        avatar_url:
          description: Profile image URL
          type: string
        display_name:
          description: X (Twitter) display name
          type: string
        twitter_id:
          description: Numeric X (Twitter) user ID
          type: string
        x_handle:
          description: X (Twitter) handle without the @ prefix
          type: string
      required:
        - twitter_id
        - display_name
        - x_handle
      type: object

````