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",
        "extraction": null,
        "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 7 days",
    "by_day": [
      { "date": "2026-06-01", "post_count": 1245, "comment_count": 3820 },
      { "date": "2026-06-02", "post_count": 1389, "comment_count": 4102 }
    ],
    "total_posts": 8920,
    "total_comments": 27450,
    "computation_mode": "precomputed"
  }
}

{
  "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": {
    "keywords": [
      { "keyword": "prabowo", "query_count": 142 },
      { "keyword": "golkar", "query_count": 87 }
    ]
  }
}

{
  "data": {
    "keyword": "prabowo",
    "period": "last 30 days",
    "by_day": [
      { "date": "2026-06-01", "post_count": 245, "total_likes": 12400, "total_comments": 3200, "total_shares": 890, "total_views": 450000, "sentiment_positive": 102, "sentiment_negative": 85, "sentiment_neutral": 58 }
    ],
    "by_platform": [
      { "platform": "x", "post_count": 4200, "total_likes": 180000, "total_comments": 45000, "total_shares": 12000, "total_views": 8500000 }
    ],
    "sentiment": {
      "positive": 3800, "negative": 2900, "neutral": 1800,
      "classified_count": 8500, "post_count": 8500,
      "coverage": 100.0,
      "positive_pct": 44.7, "negative_pct": 34.1, "neutral_pct": 21.2
    },
    "total_posts": 8500,
    "total_engagement": 520000,
    "computation_mode": "precomputed"
  }
}

{
  "data": {
    "period": "last 30 days",
    "results": [
      {
        "profile_name": "techcorp",
        "platform": "x",
        "followers": 125000,
        "engagement": 45200,
        "post_count": 87,
        "sentiment_score": 0.42,
        "authority_score": 78.5,
        "top_topics": ["AI", "cloud", "enterprise"]
      }
    ]
  }
}

{
  "data": {
    "period": "last 30 days",
    "results": [
      {
        "outlet": "kompas.com",
        "article_count": 42,
        "sentiment": 0.35,
        "reach": 1250000,
        "frequency": "2.1/day",
        "trend": "increasing"
      }
    ]
  }
}

{
  "data": {
    "period": "last 7 days",
    "topics": [
      {
        "label": "Mobile App Performance",
        "volume": 234,
        "sentiment_score": -0.15,
        "trend": "declining",
        "top_profiles": ["user1", "user2"]
      }
    ]
  }
}

{
  "data": {
    "period": "last 30 days",
    "entities": [
      { "name": "BRI", "volume": 450, "share": 45.0 },
      { "name": "BCA", "volume": 350, "share": 35.0 }
    ],
    "timeline": [
      { "period": "2026-06-01", "counts": { "BRI": 15, "BCA": 12 } }
    ]
  }
}

{
  "data": {
    "period": "last 7 days",
    "overall_risk": "medium",
    "threats": [
      {
        "title": "Customer service backlash",
        "severity": "high",
        "velocity": "increasing",
        "reach": 45000,
        "description": "Growing negative sentiment around response times",
        "recommended_actions": ["Address publicly", "Increase support staff"]
      }
    ]
  }
}

{
  "data": {
    "period": "last 7 days",
    "anomalies": [
      {
        "type": "coordinated_campaign",
        "title": "Coordinated promotion campaign",
        "confidence": 0.87,
        "severity": "medium",
        "evidence": ["12 accounts posting identical content", "All created within 48 hours"],
        "sample_posts": [123456, 789012]
      }
    ]
  }
}

{
  "data": {
    "period": "last 30 days",
    "entities": [
      {
        "entity": "BRI",
        "regulators": [
          {
            "name": "OJK",
            "mention_count": 15,
            "sentiment": -0.2,
            "key_topics": ["capital adequacy", "digital lending"]
          }
        ],
        "compliance_score": 72
      }
    ]
  }
}

{
  "data": {
    "period": "last 30 days",
    "results": [
      {
        "entity": "BRI",
        "dimension": "App Experience",
        "sentiment_score": 72.5,
        "volume": 134,
        "trend": "improving"
      },
      {
        "entity": "BCA",
        "dimension": "App Experience",
        "sentiment_score": 85.1,
        "volume": 201,
        "trend": "stable"
      }
    ]
  }
}

{
  "data": {
    "period": "last 30 days",
    "trend": [
      {
        "period": "2026-06-01",
        "scores": { "BRI": 0.35, "BCA": -0.12 }
      },
      {
        "period": "2026-06-02",
        "scores": { "BRI": 0.41, "BCA": -0.08 }
      }
    ]
  }
}

{
  "data": {
    "period": "last 7 days",
    "nodes": [
      {
        "id": "techcorp",
        "type": "account",
        "engagement": 5000,
        "sentiment": 0.3,
        "metadata": { "platform": "x", "followers": 120000 }
      },
      {
        "id": "AI Ethics",
        "type": "topic",
        "engagement": 12000,
        "sentiment": 0.1,
        "metadata": {}
      }
    ],
    "links": [
      { "source": "techcorp", "target": "aicorp", "weight": 3, "type": "mentions" },
      { "source": "techcorp", "target": "AI Ethics", "weight": 4, "type": "discusses" }
    ]
  }
}

{
  "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"],
    "profile_names": ["user1"],
    "date_from": "2026-03-01",
    "date_to": "2026-03-27",
    "content_type": "posts",
    "media_type": "video",
    "exclude_profiles": ["bot_account"],
    "exclude_keywords": ["spam"]
  }
}

{
  "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, threads, news_portal, playstore, appstore
// 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"
  }
}

// type: "posts", "comments", or "interactions"
// format: "json" (default) or "csv"

{
  "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
X-RateLimit-Reset: 1749244800
X-Credits-Charged: 5
X-Credits-Remaining: 945