API

Social Intelligence API

Analyze social signals for any topic, project, or token. Returns profiles, engagement metrics, trends, and narrative analysis across platforms.

Endpoint

GET https://api.drip.surf/social

Parameters

Parameter	Type	Required	Description
query	string	Yes	Topic, project name, or token ticker (e.g. `Solana`, `$DRIP`)
platform	string	No	Filter to a specific platform (`twitter`, `reddit`, `telegram`). Defaults to all.

Response

200 OK

{
  "status": "success",
  "data": {
    "query": "Solana",
    "profiles": [
      {
        "platform": "twitter",
        "handle": "@solana",
        "followers": 2800000,
        "engagement": {
          "avgLikes": 1200,
          "avgReposts": 340,
          "avgReplies": 89
        }
      }
    ],
    "trends": [
      {
        "topic": "Solana DeFi TVL",
        "direction": "rising",
        "mentions24h": 4200,
        "sentiment": "positive"
      }
    ],
    "engagement": {
      "totalMentions24h": 18500,
      "uniqueAuthors": 6200,
      "avgSentiment": 0.62,
      "topHashtags": ["#Solana", "#SOL", "#DeFi"]
    }
  },
  "meta": {
    "sources": ["twitter", "reddit", "telegram"],
    "confidence": 0.88,
    "costUsd": 0.05,
    "durationMs": 2850
  }
}

Examples

curl

General social query

curl "https://api.drip.surf/social?query=Solana" \
  -H "X-Payment-Proof: <tx-signature>"

Twitter only

curl "https://api.drip.surf/social?query=%24DRIP&platform=twitter" \
  -H "X-Payment-Proof: <tx-signature>"

SDK

TypeScript

import { Drip } from "@drip/sdk";

const drip = new Drip({ wallet: "<your-wallet>" });

const social = await drip.social("Solana");
console.log(social.engagement.totalMentions24h); // 18500
console.log(social.trends[0].direction);          // "rising"

// Platform-specific
const twitterOnly = await drip.social("$DRIP", {
  platform: "twitter",
});

💡Social data is collected in real time. Results reflect the past 24 hours unless otherwise noted in the response.

← Person Enrichment Sentiment →