Skip to main content
POST https://v2-api.scrapegraphai.com/api/monitor
Watches a page on a cron schedule, captures it in the formats you specify, and records change diffs between runs. Optionally ships each tick to a webhook.

​
Request body

​
url
string
required
The URL to monitor.
​
name
string
required
Human-readable monitor name.
​
interval
string
required
5-field cron expression (e.g. "*/10 * * * *", "0 9 * * 1").
​
formats
array
Formats to capture on each tick. Same shape as the Scrape formats array.
​
webhookUrl
string
URL that will receive the payload on every tick (POST).
​
fetchConfig
object
Fetch-time options. See the Scrape endpoint.

​
Example request

curl -X POST https://v2-api.scrapegraphai.com/api/monitor \
  -H "SGAI-APIKEY: $SGAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "name": "Homepage watch",
    "interval": "*/30 * * * *",
    "formats": [{ "type": "markdown" }]
  }'

​
Example response

{
  "cronId": "f0b171db-b288-4380-9cad-1bcac916348e",
  "scheduleId": "scd_4u8PPLytsJ2niWBVEAPkLHkfjVge",
  "interval": "*/30 * * * *",
  "status": "active",
  "config": {
    "url": "https://example.com",
    "name": "Doc test monitor",
    "formats": [{ "mode": "normal", "type": "markdown" }],
    "interval": "*/30 * * * *"
  },
  "createdAt": "2026-04-23T11:11:37.487Z",
  "updatedAt": "2026-04-23T11:11:37.487Z"
}
config.fetchConfig appears only when you pass fetchConfig in the request — otherwise the server uses its defaults and omits the field from the response.
FieldDescription
cronIdMonitor identifier — use it on all management endpoints.
scheduleIdInternal schedule reference.
status"active" | "paused".
configNormalized copy of the request body, including defaulted fetch options.

​
Common cron expressions

ExpressionSchedule
*/10 * * * *Every 10 minutes
*/30 * * * *Every 30 minutes
0 */6 * * *Every 6 hours
0 9 * * *Daily at 09:00 UTC
0 9 * * 1Every Monday at 09:00 UTC
0 0 1 * *First day of every month