Skip to main content
GET
/
gateway
/
v1
/
social
/
detail
Aggregated Social Analytics
curl --request GET \
  --url https://api.ask.surf/gateway/v1/social/detail
{
  "data": {
    "twitter_id": "<string>",
    "project_id": "<string>",
    "project_name": "<string>"
  },
  "meta": {
    "cached": true,
    "credits_used": 123
  },
  "$schema": "<string>"
}

Query Parameters

​
x_id
string

Numeric X (Twitter) account ID (takes priority over q)

Example:

"984188226826010624"

​
q
string

Entity name to resolve like uniswap, ethereum, or aave

Example:

"uniswap"

​
fields
string
default:sentiment,follower_geo,smart_followers

Comma-separated sub-resources to include. Can be sentiment, follower_geo, or smart_followers.

Example:

"sentiment"

​
time_range
enum<string>
default:7d

Timeframe for sentiment data. Can be 24h, 48h, 7d, 30d, 3m, 6m, or 1y.

Available options:
24h,
48h,
7d,
30d,
3m,
6m,
1y
Example:

"7d"

​
geo_limit
integer<int64>
default:20

Max geo locations to return

Required range: 1 <= x <= 100
Example:

10

Response

OK

​
data
object
required
​
meta
object
required
​
$schema
string<uri>

A URL to the JSON Schema for this object.

Example:

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