ASasksurf
Social

Project Mindshare Time Series

Changed on

Returns project social view-count time series, grouped by the required interval (5m, 1h, 1d, or 7d). Provide exactly one of id (Surf project UUID) or q (project name). Optional from/to accept Unix seconds or date strings; omitted to defaults to the current interval boundary, and omitted from defaults to 30 days before to. No pagination or time_range parameter. Source defaults to x; binance_square is also supported. Set include_tag_percents=true for per-tag percentage series and optional ranking snapshots. This measures attention, not sentiment.

get/gateway/v1/social/mindshare

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

idstring

Surf project UUID. Provide one of id or q.

Example:25c6612a-395c-4974-94eb-3b5f9f4b2ed7
qstring

Entity name to resolve like uniswap, ethereum, or aave. Provide one of id or q.

Example:uniswap
interval'5m' | '1h' | '1d' | '7d' required

Bucket size for each point in the returned time-series: 5m, 1h, 1d, or 7d. This is NOT a window — the default window is 30 days; pass from/to to bound the range. Not the same parameter as time_range (which does not exist on this endpoint). Note: when include_tag_percents=true, 5m falls back to hourly data for the per-tag series (Argus has no 5m granularity for tag percentages).

Example:1d
fromstring

Start timestamp. Accepts Unix seconds (1704067200) or date string (2024-01-01)

Example:1704067200
tostring

End timestamp. Accepts Unix seconds (1706745600) or date string (2024-02-01)

Example:1706745600
include_tag_percentsboolean

Set to true to additionally return per-tag mindshare percentage time-series in the tag_percents field. A project can belong to multiple tags; each tag returns its own sparse time-series (values are 0~100 percentages, not ratios). Default false — response shape is byte-identical to the legacy format.

Example:true
source'x' | 'binance_square'

Data lane: x (X/Twitter, default) or binance_square (Binance Square). Response shape is identical across sources.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/SocialMindshareBody.json"
}

Changes