Verosight Monitor — Social Media Intelligence Skill#

Integrate Verosight API for real-time social media monitoring and digital reputation management across major platforms.

Quick Setup#

1. Get API Key#

Sign up at verosight.com and generate an API key from the API Keys dashboard. Keys start with vlt_live_ (production) or vlt_test_ (test).

2. Authenticate#

Exchange your API key for a JWT token (valid 24 hours):

bash

JWT=$(curl -s -X POST "https://api.verosight.com/v1/auth/token" \
  -H "X-API-Key: vlt_live_YOUR_KEY" | jq -r '.token')

Or use the bundled auth script:

bash

./scripts/verosight-auth.sh vlt_live_YOUR_KEY

3. Query Data#

bash

# Sentiment analysis
curl -s "https://api.verosight.com/v1/analytics/sentiment?query=KEYWORD&sources=x,instagram&days=7" \
  -H "Authorization: Bearer $JWT"

# Search posts
curl -s "https://api.verosight.com/v1/posts?query=KEYWORD&sources=x,instagram&limit=10" \
  -H "Authorization: Bearer $JWT"

API Endpoints#

Posts#

text

GET /v1/posts

Search posts across platforms with filters.

ParameterTypeDescriptionquerystringSearch keywordsourcesstringComma-separated: x,instagram,tiktok,youtube,threads,news_portal``limitintResults per page (default: 10, max: 50)daysintLookback period (1-90)sentimentstringFilter: positive, negative, neutraltext

GET /v1/posts/:id

Get a single post by ID.

text

GET /v1/posts/:id/comments

Get comments for a post.

Analytics#

text

GET /v1/analytics/sentiment

Sentiment analysis for a keyword. Returns positive/negative/neutral breakdown, weighted percentages, and sample posts.

ParameterTypeDescriptionquerystringSearch keywordsourcesstringComma-separated platformsdaysintLookback periodlimitintNumber of sample posts to returntext

GET /v1/analytics/volume

Post/comment volume over time (daily breakdown).

text

GET /v1/analytics/trending

Trending posts and profiles for a keyword.

Profiles#

text

GET /v1/profiles?query=ACCOUNT&source=instagram

Search for social media profiles.

text

GET /v1/profiles/:source/:account

Get profile details (auto-crawls if missing).

text

GET /v1/profiles/:source/:account/stats

Engagement stats for a profile.

Search#

text

POST /v1/search

Semantic search across all content.

Body:

json

{
  "query": "keyword",
  "sources": ["x", "instagram"],
  "days": 7
}

Account#

text

GET /v1/account/balance

Check credit balance (0 cost).

text

GET /v1/account/usage

Usage history and statistics (0 cost).

Response Format#

All responses follow a standard envelope:

json

{
  "data": { ... },
  "meta": {
    "request_id": "uuid",
    "credits_used": 2,
    "credits_remaining": 998
  },
  "pagination": {
    "next_cursor": "base64...",
    "has_more": true,
    "total": 38113
  }
}

Workflows#

Sentiment Analysis Report#

1. Authenticate → get JWT
2. Query /v1/analytics/sentiment → get positive/negative/neutral breakdown
3. Query /v1/posts with sentiment=negative → identify vocal accounts
4. Query /v1/analytics/volume → trend over time
5. Compile report: overview → trend → narratives → insights → recommendations

For detailed workflow, see references/sentiment-workflow.md.

Influencer Identification#

1. Query posts about target topic with high engagement
2. Sort by likes, shares, views
3. Cross-reference with sentiment (positive vs negative influencers)
4. Profile top accounts for follower count and verification status

Bot Detection#

1. Query posts about target topic across platforms
2. Look for patterns:
   • Multiple posts from same account in short timeframe
   • Identical or near-identical content across accounts
   • Coordinated posting timing
   • New accounts with abnormally high activity
3. Flag suspicious accounts for manual review

PDF Report Generation#

Generate professional reports with tables, charts, and formatted layouts using pdfkit (Node.js).

See references/pdf-template.md for complete guide.

Supported Platforms#

PlatformCoverageX (Twitter)Posts, replies, engagement metricsInstagramPosts, captions, engagementTikTokVideos, descriptionsYouTubeVideos, commentsThreadsPosts, repliesFacebookPosts, pagesLinkedInPosts, articlesNews PortalsArticles from Indonesian media

Credit System#

Each successful API call (2xx response) costs credits. Failed calls (4xx/5xx) do not deduct credits.

TierRate LimitStarting CreditsStandard60 req/min1,000Pro300 req/min10,000EnterpriseCustomCustom

Check balance:

bash

curl -s "https://api.verosight.com/v1/account/balance" \
  -H "Authorization: Bearer $JWT"

Known Limitations#

• News portal results dominate volume (~70%); social platforms contribute less
• Semantic search returns broadly relevant results; source/date filters are limited
• Instagram direct scraping often blocked; use Verosight API for Instagram data
• Profile metadata (followers, account age) may not be available for all accounts

Bundled Resources#

FilePurposereferences/sentiment-workflow.mdStep-by-step sentiment analysis workflow with report templatereferences/pdf-template.mdPDF generation guide with pdfkit (tables, charts, layout)scripts/verosight-auth.shAuth helper — exchange API key for JWTscripts/quick-sentiment.shQuick sentiment check from command line

Links#

• Verosight API
• API Dashboard
• Documentation
• ClawHub
• GitHub