Skip to main content
GET
/
gateway
/
v1
/
social
/
ranking
Social Mindshare Ranking
curl --request GET \
  --url https://api.ask.surf/gateway/v1/social/ranking
{
  "data": [
    {
      "rank": 123,
      "sentiment": "<string>",
      "sentiment_score": 123,
      "tags": [
        "<string>"
      ],
      "trending_short_reason": "<string>",
      "trending_summary": "<string>"
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "<string>"
}

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

OK

​
data
object[] | null
required
​
meta
object
required
​
$schema
string<uri>

A URL to the JSON Schema for this object.

Example:

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