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):

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:

./scripts/verosight-auth.sh vlt_live_YOUR_KEY

3. Query Data

# 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

GET /v1/posts

Search posts across platforms with filters.

| Parameter | Type | Description | |-----------|------|-------------| | query | string | Search keyword | | sources | string | Comma-separated: x,instagram,tiktok,youtube,threads,news_portal | | limit | int | Results per page (default: 10, max: 50) | | days | int | Lookback period (1-90) | | sentiment | string | Filter: positive, negative, neutral |

GET /v1/posts/:id

Get a single post by ID.

GET /v1/posts/:id/comments

Get comments for a post.

Analytics

GET /v1/analytics/sentiment

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

| Parameter | Type | Description | |-----------|------|-------------| | query | string | Search keyword | | sources | string | Comma-separated platforms | | days | int | Lookback period | | limit | int | Number of sample posts to return |

GET /v1/analytics/volume

Post/comment volume over time (daily breakdown).

GET /v1/analytics/trending

Trending posts and profiles for a keyword.

Profiles

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

Search for social media profiles.

GET /v1/profiles/:source/:account

Get profile details (auto-crawls if missing).

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

Engagement stats for a profile.

Search

POST /v1/search

Semantic search across all content.

Body:

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

Account

GET /v1/account/balance

Check credit balance (0 cost).

GET /v1/account/usage

Usage history and statistics (0 cost).

Response Format

All responses follow a standard envelope:

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

Workflows

Sentiment Analysis Report

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

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

Influencer Identification

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

Bot Detection

Query posts about target topic across platforms
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
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

| Platform | Coverage | |----------|----------| | X (Twitter) | Posts, replies, engagement metrics | | Instagram | Posts, captions, engagement | | TikTok | Videos, descriptions | | YouTube | Videos, comments | | Threads | Posts, replies | | Facebook | Posts, pages | | LinkedIn | Posts, articles | | News Portals | Articles from Indonesian media |

Credit System

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

| Tier | Rate Limit | Starting Credits | |------|-----------|-----------------| | Standard | 60 req/min | 1,000 | | Pro | 300 req/min | 10,000 | | Enterprise | Custom | Custom |

Check balance:

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

| File | Purpose | |------|---------| | references/sentiment-workflow.md | Step-by-step sentiment analysis workflow with report template | | references/pdf-template.md | PDF generation guide with pdfkit (tables, charts, layout) | | scripts/verosight-auth.sh | Auth helper — exchange API key for JWT | | scripts/quick-sentiment.sh | Quick sentiment check from command line |