How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Surf Social API

Monitor crypto social activity on X (Twitter). Look up user profiles and their posts, track project sentiment scores and follower geography, discover smart followers, and analyze mindshare trends over time to gauge social momentum.

Surf Social API is one of 16 APIs that Surf publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Social. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 12 operations across 12 paths, and defines 34 schemas. It is described by OpenAPI 3.2.0, at version sha-80d3407.

Requests are made against a single base URL, /.

12 operations 12 paths 34 schemas 12 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
sha-80d3407
Base URL
https://api.asksurf.ai/gateway/v1
Authentication
HTTP Bearer, API Key, API Key
Contact
Resource Areas
1

Authentication & Security 3

Surf Social API declares 3 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (AccessToken). An API key is passed in the header as X-Admin-Token (AdminToken). An API key is passed in the header as X-Internal-Key (InternalKey).

Paths & Operations 12

Across 12 paths, the API surfaces 12 operations — 12 GET. Each is listed below with its method, path, parameters, and response codes.

Social 12

Monitor crypto social activity on X (Twitter). Look up user profiles and their posts, track project sentiment scores and follower geography, discover smart followers, and analyze…

GET
/gateway/v1/social/detail
Aggregated Social Analytics
social-detail 5 params → 200default
GET
/gateway/v1/social/mindshare
Project Mindshare Time Series
social-mindshare 7 params → 200default
GET
/gateway/v1/social/ranking
Social Mindshare Ranking
social-ranking 6 params → 200default
GET
/gateway/v1/social/sentiment
Social Sentiment
social-sentiment 2 params → 200default
GET
/gateway/v1/social/smart-followers/history
Smart Follower Count History
social-smart-followers-history 3 params → 200default
GET
/gateway/v1/social/tweet/replies
Tweet Replies
social-tweet-replies 3 params → 200default
GET
/gateway/v1/social/tweets
Social Posts by IDs
social-tweets 1 param → 200default
GET
/gateway/v1/social/user
Social User Profile
social-user 1 param → 200default
GET
/gateway/v1/social/user/followers
User Followers List
social-user-followers 3 params → 200default
GET
/gateway/v1/social/user/following
User Following List
social-user-following 3 params → 200default
GET
/gateway/v1/social/user/posts
User Social Posts
social-user-posts 4 params → 200default
GET
/gateway/v1/social/user/replies
User Replies
social-user-replies 3 params → 200default

Schemas 34

The contract defines 34 schemas that model the data the API accepts and returns. The most detailed are XTweet (11 properties), SmartFollowerItem (9 properties), MindshareTopProject (9 properties), OffsetMeta (8 properties). Each schema is shown below with its type and property counts.

XUser
object
7 properties 5 required
SentimentData
object
3 properties 2 required
SocialSentimentItem
object
5 properties 3 required
DataAPIErrorDetail
object
2 properties 2 required
OffsetMeta
object
8 properties 4 required
SmartFollowersData
object
2 properties 2 required
SmartFollowerHistoryPoint
object
2 properties 2 required
DataResponseSmartFollowerHistoryPoint
object
3 properties 2 required
FollowerGeoData
object
2 properties 2 required
DataObjectResponseSocialDetailBody
object
3 properties 2 required
SocialMindsharePoint
object
2 properties 2 required
XMedia
object
2 properties 2 required
MindshareTopTokenInfo
object
4 properties 1 required
ProjectTagMindshareSeries
object
4 properties 2 required
ObjectResponseMeta
object
3 properties 2 required
MindshareTopTwitterInfo
object
4 properties 3 required
MindshareTagPercentPoint
object
2 properties 2 required
DataResponseXTweet
object
3 properties 2 required
DataAPIError
object
2 properties 1 required
DataObjectResponseSocialSentimentItem
object
3 properties 2 required
DataObjectResponseXUser
object
3 properties 2 required
SmartFollowerItem
object
9 properties 8 required
MindshareTopProjectInfo
object
3 properties 2 required
SocialDetailBody
object
6 properties 1 required
MindshareTopProject
object
9 properties 1 required
SocialMindshareBody
object
4 properties 2 required
DataResponseMindshareTopProject
object
3 properties 2 required
CursorDataResponseXTweet
object
3 properties 2 required
CursorDataResponseXUser
object
3 properties 2 required
CursorMeta
object
7 properties 4 required
XStats
object
4 properties 4 required
XAuthor
object
4 properties 3 required
FollowerGeoItem
object
3 properties 3 required
XTweet
object
11 properties 6 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

surf-social-api-openapi.yml Raw ↑

Other APIs Surf publishes across the network.

Surf Chat API
Surf DEX API
Surf Exchange API
Surf Fund API
Surf Hyperliquid API
Surf Market API
Surf News API
Surf Onchain API
Surf Prediction Market API
Surf Project API
Surf Search API
Surf Signal API
Where this information came from

This is an independent, third-party profile of Surf Social API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.