API reference

Monitors

Watch a page for changes on a schedule.

POSThttps://api.scrapeflow.dev/v1/monitors1 credit per check

Creates a scheduled monitor (backed by EventBridge). When the page changes, ScrapeFlow POSTs a diff to your webhook. Track pricing, docs, and competitor pages.

Request

curl -X POST ${SCRAPEFLOW_API_URL}/v1/monitors \
  -H "Authorization: Bearer $SCRAPEFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/pricing", "everyHours": 6, "webhook": "https://api.acme.com/hooks/sf" }'

Parameters

ParameterTypeDescription
urlrequiredstringThe URL to watch.
everyHoursrequirednumberCheck interval in hours.
webhookrequiredstringURL to POST change events to.
selectorstringOnly watch a CSS selector's content.

Response

json
{ "success": true, "monitor_id": "mon_7c1b", "status": "active" }