X-API-Key: vlt_live_a1b2c3d4e5f6...

{
  "token": "eyJ...",
  "expires_at": "2026-03-28T10:00:00Z"
 }

Authorization: Bearer eyJ...

{
  "data": {
    "credits_remaining": 971,
    "credits_used_today": 29,
    "tier": "standard",
    "rate_limit": 60,
    "rate_limit_remaining": 55
  }
}

{
  "data": {
    "total_credits_used": 145,
    "total_requests": 42,
    "success_rate": 95.2,
    "avg_latency_ms": 187,
    "by_endpoint": [
      { "endpoint": "GET /v1/posts", "requests": 20, "credits": 40 }
    ],
    "by_day": [
      { "date": "2026-03-27", "requests": 15, "credits": 45 }
    ]
  }
}

{
  "data": {
    "period": "last 7 days",
    "top_posts": [
      {
        "id": 451,
        "platform": "instagram",
        "post_id": "DWz31kkiXu7",
        "profile_name": "example_profile_a",
        "content": "Sample trending post content preview.",
        "media_type": "text",
        "media_urls": [],
        "post_url": "https://example.com/p/DWz31kkiXu7/",
        "like_count": 2931,
        "comment_count": 177,
        "hashtags": [],
        "mentions": [],
        "is_reply": false,
        "posted_at": "2026-04-07T07:34:36+07:00"
      },
      ...
    ],
    "top_profiles": [
      {
        "profile_name": "example_profile_a",
        "platform": "instagram",
        "total_engagement": 8861,
        "post_count": 5
      },
      {
        "profile_name": "example_profile_b",
        "platform": "linkedin",
        "total_engagement": 3283,
        "post_count": 5
      }
    ],
    ...
  }
}

{
  "data": {
    "query": "indonesia",
    "total": 500,
    "positive": 45, 
    "negative": 12, 
    "neutral": 443,
    "positive_pct": 9.0, 
    "negative_pct": 2.4, 
    "neutral_pct": 88.6,
    "sample_positive": [ ... ],
    "sample_negative": [ ... ]
  }
}

{
  "data": [
    {
      "query": "indonesia",
      "period": "last 7 days",
      "total": 500,
      "positive": 45,
      "negative": 12,
      "neutral": 443,
      "positive_pct": 9.0,
      "negative_pct": 2.4,
      "neutral_pct": 88.6,
      "sample_positive": [ ... ],
      "sample_negative": [ ... ]
    }, 
    ...
    ]
}

{
  "data": {
    "period": "last 7 days",
    "rankings": [
      {
        "profile_name": "ignasius.jonan",
        "platform": "instagram",
        "total_engagement": 8861,
        "post_count": 5
      },
      ...
    ]
  }
}

{
  "data": {
    "period": "last 2 days",
    "topics": [
      { "name": "berita hari ini", "post_count": 7 },
      { "name": "berita terbaru", "post_count": 6 },
      { "name": "berita terkini", "post_count": 6 },
      { "name": "breaking news", "post_count": 6 },
      ...
    ],
    "retrieval_mode": "hashtag"
  }
}

{
  "data": {
    "period": "last 7 days",
    "profiles": [
      {
        "profile_name": "detikcom",
        "platform": "x",
        "post_count": 0,
        "total_likes": 0,
        "total_comments": 0,
        "total_shares": 0,
        "avg_engagement_per_post": 0
      },
      {
        "profile_name": "kompascom",
        "platform": "x",
        "post_count": 0,
        "total_likes": 0,
        "total_comments": 0,
        "total_shares": 0,
        "avg_engagement_per_post": 0
      },
      ...
    ]
  }
}

{
  "data": {
    "query": "saham",
    "period": "last 30 days",
    "experts": [
      {
        "profile_name": "kumparan",
        "platform": "tiktok",
        "post_count": 12,
        "total_likes": 41919,
        "total_comments": 782,
        "total_shares": 1924,
        "avg_relevance": 0.8242052565862732,
        "authority_score": 23.754982334310558
      },
      {
        "profile_name": "detikcom",
        "platform": "x",
        "post_count": 25,
        "total_likes": 3788,
        "total_comments": 188,
        "total_shares": 350,
        "avg_relevance": 0.818417328608031,
        "authority_score": 21.872244414782003
      },
      ...
    ],
    "retrieval_mode": "semantic"
  }
}

{
  "data": {
    "period": "last 7 days",
    "by_day": [
      { "date": "2026-05-08", "positive": 120, "negative": 30, "neutral": 450 },
      { "date": "2026-05-09", "positive": 135, "negative": 28, "neutral": 460 }
    ],
    "computation_mode": "precomputed"
  }
}

{
  "data": {
    "period": "last 7 days",
    "hashtags": [
      { "hashtag": "indonesia", "post_count": 342, "engagement": 58210 },
      { "hashtag": "viral", "post_count": 215, "engagement": 41030 }
    ],
    "computation_mode": "precomputed"
  }
}

{
  "data": {
    "period": "last 7 days",
    "mentions": [
      { "mentioned_profile": "jabordes", "mention_count": 89, "engagement": 12340 },
      { "mentioned_profile": "anabordes", "mention_count": 67, "engagement": 8920 }
    ],
    "computation_mode": "precomputed"
  }
}

{
  "data": {
    "period": "all time",
    "slots": [
      { "day_of_week": 1, "hour": 9, "post_count": 45, "avg_engagement": 1234.56 },
      { "day_of_week": 3, "hour": 19, "post_count": 38, "avg_engagement": 1180.20 }
    ],
    "computation_mode": "precomputed"
  }
}

{
  "data": {
    "period": "last 30 days",
    "snapshots": [
      { "date": "2026-04-15", "total_followers": 125000, "total_following": 500, "total_posts": 3200 },
      { "date": "2026-04-16", "total_followers": 125340, "total_following": 501, "total_posts": 3205 }
    ],
    "computation_mode": "precomputed"
  }
}

{
  "data": [
    {
      "name": "Wireless Charging Pad",
      "brand": "Baseus",
      "category": "Electronics",
      "profit_potential": "high",
      "reason": "Surge in discussion across tech communities after new phone launches",
      "confidence": 0.87
    },
    {
      "name": "Phone Grip Stand",
      "brand": "Generic",
      "category": "Accessories",
      "profit_potential": "medium",
      "reason": "Consistent demand driven by content creators and streamers",
      "confidence": 0.74
    }
  ]
}

{
  "query": "social media analytics",
  "limit": 20,
  "filters": {
    "platforms": ["x", "instagram"],
    "date_from": "2026-03-01",
    "date_to": "2026-03-27"
  }
}

{
  "queries": [
    {
      "query": "social media analytics",
      "limit": 20,
      "filters": {
        "platforms": ["x", "instagram"],
        "profile_names": ["user1"],
        "date_from": "2026-03-01",
        "date_to": "2026-03-27",
        "content_type": "posts"
      }
    },
    ...
  ]
}

{
  "platform": "x",
  "profile_id": "KompasTV",
  "label": "Kompas TV",
  "post_limit": 50,
  "comment_limit": 100,
  "schedule_enabled": false,
  "schedule_interval_minutes": 1440
}

// platform: x, instagram, tiktok, facebook, linkedin, youtube, news_portal
// post_limit: default 50 | comment_limit: default 100
// schedule_enabled: default false
// Returns 409 if you are already monitoring this profile.
// Re-adding a previously deleted seed reactivates it.

{
  "data": {
    "seed_id": "af1b06b8-...",
    "status": "pending",
    "message": "Crawl scheduled. Position #2 in queue, estimated wait ~8 minutes.",
    "queue_position": 1,
    "estimated_wait_minutes": 8,
    "created_at": "2026-03-31T14:00:00Z"
  }
}

// Returns 409 if a crawl is already pending or running.

{
  "message": "What are the trending topics about Indonesia?",
  "conversation_id": "optional — omit to create new conversation"
}

data: {"type":"conversation_id","id":"550e8400-..."}
data: {"type":"tool_status","name":"get_trending","label":"Getting trending data","status":"running"}
data: {"type":"tool_status","name":"get_trending","label":"Getting trending data","status":"done"}
data: {"type":"content_block_delta","delta":{"text":"## Trending Topics\n"}}
data: {"type":"done"}

{
  "type": "posts",
  "format": "csv",
  "filters": {
    "platform": "x",
    "date_from": "2026-03-01",
    "date_to": "2026-03-27"
  }
}

{
  "data": {
    "job_id": "uuid",
    "status": "completed",
    "rows": 5432,
    "credits_charged": 100,
    "download_url": "https://...",
    "expires_at": "2026-03-29T10:00:00Z"
  }
}

URL: https://api.verosight.com/v1/mcp/sse
Headers:
  X-API-Key: vlt_live_YOUR_KEY

{
  "mcpServers": {
    "verosight": {
      "url": "https://api.verosight.com/v1/mcp/sse",
      "headers": {
        "X-API-Key": "vlt_live_YOUR_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "verosight": {
      "serverUrl": "https://api.verosight.com/v1/mcp/sse",
      "headers": {
        "X-API-Key": "vlt_live_YOUR_KEY"
      }
    }
  }
}

curl -fsSL https://verosight.com/download/mcp/install.sh | sh

{
  "mcpServers": {
    "verosight": {
      "command": "verosight-mcp",
      "env": {
        "VEROSIGHT_API_KEY": "vlt_live_YOUR_KEY"
      }
    }
  }
}

/plugin install https://github.com/volantis-technology/verosight-claude-plugin

export VEROSIGHT_API_KEY=vlt_live_YOUR_KEY
/verosight:setup

/verosight:search posts about AI from last week
/verosight:trending on tiktok
/verosight:sentiment iran conflict
/verosight:profile x KompasTV
/verosight:compare KompasTV vs Metro_TV on twitter
/verosight:balance

{
  "error": {
    "code": "insufficient_credits",
    "message": "This request costs 5 credits but you have 2 remaining."
  },
  "meta": { "request_id": "uuid" }
 }

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 55