Mindshare Ranking

GET /gateway/v1/social/ranking

Social Mindshare Ranking

cURL

curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/social/ranking

200

{
  "data": [
    {
      "rank": 123,
      "project": {
        "id": "<string>",
        "name": "<string>",
        "slug": "<string>"
      },
      "sentiment": "<string>",
      "sentiment_score": 123,
      "tags": [
        "<string>"
      ],
      "token": {
        "name": "<string>",
        "id": "<string>",
        "image": "<string>",
        "symbol": "<string>"
      },
      "trending_short_reason": "<string>",
      "trending_summary": "<string>",
      "twitter": {
        "display_name": "<string>",
        "twitter_id": "<string>",
        "x_handle": "<string>",
        "avatar_url": "<string>"
      }
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "https://example.com/schemas/DataResponseMindshareTopProject.json"
}

Query Parameters

offset · integer<int64> · default: 0

Pagination offset

Required range: x >= 0

Example:

0

limit · integer<int64> · default: 20

Results per page

Required range: 1 <= x <= 100

Example:

20

tag · enum<string>

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.

Available options: l1, l2, dex, derivatives, cex, gamefi, nft, oracle, prediction, rwa, yield, data, devtool, compliance, meme,

Example:

"dex"

time_range · enum<string> · default: 7d

Mindshare ranking timeframe window

Available options: 24h, 48h, 7d, 30d

Example:

"7d"

sentiment · enum<string>

Filter by sentiment polarity. Only projects with sufficient tweet data are classified.

Available options: positive, negative,

Example:

"positive"

Response

200

application/json

OK

data · object[] | null · required

Show child attributes

meta · object · required

Show child attributes

$schema · string<uri> · read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponseMindshareTopProject.json"