# Verosight — Full Site Content > Social media intelligence API. Access real-time data from X, Instagram, TikTok, Facebook, LinkedIn, YouTube, and news portals. --- ## Homepage (https://verosight.com) Verosight provides intelligent data across the internet. Collect, analyze, and transform social media and news data into actionable intelligence — powered by advanced AI. A subsidiary of Volantis. Products: - API Platform: Access internet-scale social and news data through a simple, powerful API - Analytics Platform: Turn raw social data into clear, actionable dashboards and reports What You Can Do with Verosight: - AI Chat: Ask questions about social trends in plain language. Get instant insights without writing a single query. - Recommendations: AI-generated product, content, and marketing suggestions powered by real social conversations. - Analytics: Sentiment analysis, trending topics, engagement rankings, and expert identification in one place. - Semantic Search: Find posts and profiles by meaning, not just keywords. Powered by vector search across millions of data points. - Profile Monitoring: Track any profile across platforms. Auto-collect posts, comments, and interactions as they happen. - Data Export: Export any dataset to CSV for your own analysis, reports, or to feed into your existing workflows. --- ## API Platform (https://verosight.com/api-platform) Access internet-scale social and news data through a simple, powerful API. Build smarter applications and supercharge your AI agents. Features: - RESTful API: Clean, well-documented endpoints with predictable response formats - MCP Compatible: Use as a Model Context Protocol server for AI assistants like Claude and Cursor - Real-time Data: Stream or poll fresh data from X, Instagram, TikTok, YouTube, news portals, and more - Enterprise Scale: High-throughput infrastructure designed for millions of requests. 99.9% uptime SLA What You Can Build: - AI Chat with Your Data (/v1/chat): Ask questions about social trends in natural language. The AI agent analyzes posts, profiles, and sentiments in real time — no queries to write, just ask. - Smart Recommendations (/v1/recommendations): Generate AI-powered product, content, and marketing recommendations based on real social conversations. Supports products, movies, books, software, and more. - Analytics & Insights (/v1/analytics): Trending topics, sentiment analysis, engagement rankings, profile comparisons, and expert identification — all through a single API. - Semantic Search (/v1/search): Search across millions of posts and profiles using vector-based semantic search. Find similar content, discover related discussions, and surface hidden patterns. - Profile Monitoring (/v1/seeds): Track profiles across X, Instagram, TikTok, YouTube, and more. Auto-crawl new posts, comments, and interactions from the profiles you care about. - Data Export (/v1/export): Export your data to CSV for offline analysis, reporting, and integration with your existing tools and workflows. --- ## Analytics Platform (https://verosight.com/analytics-platform) Turn raw social data into clear, actionable dashboards and reports. Monitor brands, track campaigns, and analyze competitors. --- ## API Documentation (https://verosight.com/docs) ### Getting Started Base URL: https://api.verosight.com Quick start: 1. Create an account at https://verosight.com/register and get 1,000 free credits 2. Generate an API key from the dashboard 3. Exchange key for JWT: POST /v1/auth/token with X-API-Key header 4. Make requests with Authorization: Bearer Response format: { "data": ..., "meta": { "request_id", "credits_used", "credits_remaining" }, "pagination": { "next_cursor", "has_more", "total" } } ### Authentication Two methods: 1. API Key: X-API-Key header with vlt_live_ or vlt_test_ prefixed key 2. JWT Bearer: Exchange API key for 24h JWT via POST /v1/auth/token ### Account GET /v1/account/balance (0 credits) — Returns credits_remaining, credits_used_today, tier, rate_limit GET /v1/account/usage?days=7&key_id= (0 credits) — Usage stats with by_endpoint and by_day breakdown, success_rate, avg_latency_ms GET /health (no auth) — System health check GET /v1/sources (no auth) — List supported platforms and their status ### Posts GET /v1/posts (2 credits) — Search posts. Params: platform (case-insensitive), profile_name, keyword, media_type, date_from, date_to, min_likes, sort, order, limit, cursor, exclude_profiles (comma-separated profile names to exclude), exclude_keywords (comma-separated keywords to exclude) GET /v1/posts/:id (1 credit) — Single post by ID GET /v1/posts/:id/comments (2 credits) — Comments on a post ### Comments GET /v1/comments (2 credits) — Search comments. Params: platform, profile_name, post_owner, keyword, date_from, date_to, limit, cursor, exclude_profiles (comma-separated profile names to exclude), exclude_keywords (comma-separated keywords to exclude) GET /v1/comments/:id (1 credit) — Single comment ### Profiles GET /v1/profiles (2 credits) — Browse profiles. Params: platform, search, is_verified, min_followers, limit, cursor GET /v1/profiles/:platform/:name (1 credit) — Profile details. Auto-triggers crawl if profile not in database. GET /v1/profiles/:platform/:name/posts (2 credits) — Profile's posts GET /v1/profiles/:platform/:name/comments-received (2 credits) — Comments on profile's posts GET /v1/profiles/:platform/:name/interactions (2 credits) — Interaction graph edges GET /v1/profiles/:platform/:name/stats?days=7 (5 credits) — Engagement statistics ### Analytics GET /v1/analytics/trending (5 credits) — Top posts and profiles by engagement. Params: days, limit, platform, keyword (optional — filter trending content by topic), exclude_profiles (comma-separated profile names to exclude), exclude_keywords (comma-separated keywords to exclude) GET /v1/analytics/sentiment?query= (5 credits) — Sentiment analysis. Returns total, positive, negative, neutral counts and percentages with sample posts. Params: query (required, use pipe " | " as separator to analyze multiple query in a single request), days, platform, exclude_profiles (comma-separated), exclude_keywords (comma-separated) GET /v1/analytics/engagement-ranking (5 credits) — Profiles ranked by engagement. Params: days, limit, platform, keyword (optional — filter by topic to rank engagement on posts about a specific subject), exclude_profiles (comma-separated), exclude_keywords (comma-separated) GET /v1/analytics/topics (5 credits) — Topic summaries from hashtags. Params: days, limit, platform, keyword (optional — filter posts before clustering to narrow topics to a subject area), exclude_profiles (comma-separated), exclude_keywords (comma-separated) GET /v1/analytics/compare?profiles=x:user1,x:user2 (5 credits) — Side-by-side profile comparison GET /v1/analytics/experts?query=&days=30&limit=20 (5 credits) — Find topic experts ranked by authority. Params: query (required), days (default 30), limit (default 20), platform, exclude_profiles (comma-separated), exclude_keywords (comma-separated) GET /v1/analytics/sentiment-trend (3 credits) — Daily sentiment breakdown (positive/negative/neutral counts per day). Params: days (default 7), platform, keyword (optional — filter by topic using semantic search) GET /v1/analytics/hashtags (3 credits) — Trending hashtags ranked by engagement. Params: days (default 7), limit (default 20), platform, keyword (optional — find hashtags used in topic-relevant posts) GET /v1/analytics/mentions (3 credits) — Most-mentioned profiles ranked by mention count. Params: days (default 7), limit (default 20), platform, keyword (optional — find mentions in topic-relevant posts) GET /v1/analytics/best-time (3 credits) — Best posting times by engagement heatmap (hour × day-of-week). Params: platform, profile_name, keyword (optional — analyze topic-specific posting times), days (lookback when using keyword, default 30) GET /v1/analytics/growth (3 credits) — Follower/following growth over time for a specific profile. Params: platform (required), profile_name (required), days (default 30) ### Recommendations GET /v1/recommendations/:name (15 credits) — AI-generated recommendations derived from social media buzz. Params: query (topic, required), days (lookback window), platform. Available recommendation types: - products — what products have business potential based on social trends - movies — currently airing and trending movies (e.g. "project hail mary") - books — books gaining traction in online communities - software — mobile apps, web tools, productivity software, trending AI tools - games — video games gaining popularity or strong engagement - travel — popular or emerging travel destinations based on social buzz and seasonal trends - skills — courses and skills trending in demand (AI, coding, business, design) - content — post ideas, hooks, captions, and content formats (e.g. "create short-form videos about x trend using humor tone") - marketing — campaign angles and messaging strategies - problems — common complaints and unmet needs surfaced from social data (e.g. "users frustrated with slow delivery in x category") ### Search POST /v1/search (5 credits) — Semantic search. Request body for single search: { "query": "...", "limit": 20, "filters": { "platforms": [], "date_from": "", "date_to": "", "exclude_profiles": [], "exclude_keywords": [] } } Request body for multiple search: { "queries": [ { "query": "...", "limit": 20, "filters": { "platforms": [], "date_from": "", "date_to": "", "exclude_profiles": [], "exclude_keywords": [] } }, ...] } GET /v1/search/similar/:id (5 credits) — Find similar posts ### Seeds & Crawl GET /v1/seeds (0 credits) — List monitored profiles POST /v1/seeds (0 credits) — Add seed. Body: { "platform": "x", "profile_id": "username", "label": "", "post_limit": 50, "comment_limit": 100, "schedule_enabled": false, "schedule_interval_minutes": 1440 }. Platforms: x, instagram, tiktok, facebook, linkedin, youtube, news_portal. Returns 409 if already monitoring. Re-adding a deleted seed reactivates it. DELETE /v1/seeds/:id (0 credits) — Stop monitoring (soft delete). Data preserved, re-adding reactivates. POST /v1/seeds/:id/crawl (10 credits) — Trigger crawl. Returns queue position and estimated wait time. Returns 409 if crawl already pending or running. GET /v1/seeds/:id/jobs (1 credit) — Crawl history with status and human-readable messages ### Export POST /v1/export (0 credits) — Start export job. Body: { "type": "posts", "format": "csv", "filters": {} } GET /v1/export/:jobId (0 credits) — Check export status, get download URL ### AI Chat POST /v1/chat (20 credits) — AI chat with tool-use, SSE streaming. Body: { "message": "your question", "conversation_id": "optional-uuid" }. Omit conversation_id to start a new conversation. Returns SSE events: conversation_id (with new/existing ID), tool_status (running/done/error), content_block_delta (streaming text), done. Backend manages conversation context automatically. Available chat tools: search_posts (supports sort=engagement to re-rank semantic results by engagement), get_trending, get_sentiment, get_topics, get_engagement_ranking, get_sentiment_trend, get_hashtag_trending, get_mention_ranking, get_best_time, get_growth, list_posts, get_profile, list_profiles, get_profile_stats, find_experts, recommend_products, recommend_movies, recommend_books, recommend_software, recommend_games, recommend_travel, recommend_skills, recommend_content, recommend_marketing, recommend_problems. All platform parameters are case-insensitive. Search and aggregation tools support optional exclude_profiles and exclude_keywords arrays to filter out specific accounts or content containing certain keywords; pre-computed analytics (sentiment-trend, hashtags, mentions, best-time, growth) do not. ### Conversations GET /v1/conversations (0 credits) — List chat conversations, newest first. Params: limit, offset GET /v1/conversations/:id (0 credits) — Get conversation with all messages DELETE /v1/conversations/:id (0 credits) — Delete conversation PATCH /v1/conversations/:id (0 credits) — Rename conversation. Body: { "title": "new title" } ### MCP Server Install: curl -fsSL https://verosight.com/download/mcp/install.sh | sh Claude Desktop config: { "mcpServers": { "verosight": { "command": "verosight-mcp", "env": { "VEROSIGHT_API_KEY": "vlt_live_YOUR_KEY" } } } } 19 MCP tools: search_posts, get_post, search_comments, list_profiles, get_profile, get_profile_stats, get_trending, analyze_sentiment, get_volume, get_topics, compare_profiles, find_experts, get_sentiment_trend, get_hashtag_trending, get_mention_ranking, get_best_time, get_growth, semantic_search, get_balance ### Errors 400 invalid_request — Bad request 401 invalid_api_key — Missing or invalid credentials 401 token_expired — JWT expired 402 insufficient_credits — Not enough credits 404 not_found — Resource not found 429 rate_limited — Too many requests (check Retry-After header) 500 server_error — Internal error ### Rate Limits & Pricing Standard tier: 60 requests/min, 1,000 free credits Pro tier: 120 requests/min, purchased credits Enterprise tier: Custom limits Headers: X-RateLimit-Limit, X-RateLimit-Remaining --- ## Release Notes (https://verosight.com/release-notes) Stay up to date with the latest improvements, new features, and bug fixes across the Verosight platform. --- ## Status (https://verosight.com/status) Real-time service health monitoring for all Verosight API endpoints. Checks API Gateway, Posts API, Profiles API, Analytics API, Search API, and Sources API. --- ## Contact (https://verosight.com/contact) Contact Verosight for enterprise inquiries, partnership opportunities, or support. --- ## Legal Privacy Policy: https://verosight.com/privacy Terms & Conditions: https://verosight.com/terms Disclaimer: Verosight is not affiliated with, endorsed by, or associated with any brand, organization, or individual whose content appears on this platform. All data collected and displayed is sourced from publicly available information. Users are solely responsible for ensuring their use of this data complies with applicable laws and regulations.