Monitors and webhooks

Watch a profile or search. We send you the new items.

Create one

Preview
curl -X POST "https://api.socialscrape.io/v1/monitors" \
  -H "x-api-key: $SOCIALSCRAPE_API_KEY" \
  -H "content-type: application/json" \
  -d '{
        "endpoint": "/v1/youtube/channel/videos",
        "params": { "handle": "mkbhd" },
        "interval_minutes": 60,
        "webhook_url": "https://example.com/hooks/socialscrape"
      }'
Preview
The API is in early access. Calls use api.socialscrape.io and return the shapes in the reference.

The facts

Interval15 to 1,440 minutes
CostEach check is billed like your own request to that endpoint. A failed check is free.
BaselineThe first check records what exists, so you get no flood of old items.
SignatureHMAC-SHA256 over the raw body, timestamp included
Retries6 attempts over about 15 hours, then a dead letter you can redeliver
Limit100 monitors per team

Used in

Verification code for Python and Node.js is in the guide.

Questions

What if my server is down?

The event is retried six times, then kept as a dead letter. Send it again from the delivery log once the receiver is fixed.

Build on social data early.

Developers and agent builders get the first keys.

Get early access