Quick Start

1. Get your API key

Sign in to the dashboard, click + New key, and copy the value shown. You'll see the raw key once — store it somewhere safe.

2. Monitor a social media account

Give us the page or account URL (Facebook or X). We start watching it for new posts within seconds.

curl -X POST https://api.social2llm.com/v2/monitors \
  -H "X-API-Key: soc_..." \
  -H "Content-Type: application/json" \
  -d '{"platform": "x", "page_url": "https://x.com/tvn24"}'
# {"id":"mon_xyz789","platform":"x","status":"active"}

3. Receive post + engagement webhooks

Pass callback_url when creating the monitor and we POST that URL for every new post — text, engagement counts (reactions, comments, shares), and a resolved source link when available. The payload includes full post metadata for LLM processing.

curl -X POST https://api.social2llm.com/v2/monitors \
  -H "X-API-Key: soc_..." \
  -d '{"platform":"x","page_url":"https://x.com/tvn24","callback_url":"https://your-app.example/webhook"}'

# Delivered on each new post:
# {
#   "event": "post.created",
#   "monitor_id": "mon_xyz789",
#   "platform": "x",
#   "post": {
#     "platform_post_id": "1234567890",
#     "permalink": "https://x.com/tvn24/status/1234567890",
#     "page": {"page_id":"tvn24","page_name":"TVN24","page_url":"https://x.com/tvn24"},
#     "text": "Tweet text content...",
#     "metrics": {"reactions":256,"comments":45,"shares":89,"metrics_at":"2026-08-25T14:35:00Z"},
#     "resolved_link": {"url":"https://example.com/article","og_title":"Article title","og_description":"Article description","og_image":"https://example.com/image.jpg"}
#   }
# }

4. Check on a monitor

Fetch its current status any time, or reactivate it if you'd stopped it earlier.

curl https://api.social2llm.com/v2/monitors/mon_abc123 \
  -H "X-API-Key: soc_..."

curl -X POST https://api.social2llm.com/v2/monitors/mon_abc123/reactivate \
  -H "X-API-Key: soc_..."

5. Stop monitoring

DELETE the monitor when you no longer need it. History already delivered is unaffected.

curl -X DELETE https://api.social2llm.com/v2/monitors/mon_abc123 \
  -H "X-API-Key: soc_..."

6. Check your usage

The dashboard's Usage panel shows your metered events aggregated by kind.