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 Facebook page

Give us the page's public URL. 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": "facebook", "page_url": "https://www.facebook.com/<page>"}'
# {"id":"mon_abc123","platform":"facebook","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, and a link to the first comment.

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

# Delivered on each new post:
# {"monitor_id":"mon_abc123","post_id":"...","post_url":"...","text":"...",
#  "engagement":{"reactions":128,"comments":34,"shares":12},
#  "first_comment_url":"https://www.facebook.com/.../?comment_id=..."}

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.