Watch

POST1 credit / check (+3 if AI used)

https://api.crawlkit.sh/watch

Monitor normalized content or selected fields and receive signed change events.

Try on Playground

Authentication

Send your Crawlkit API key directly in the Authorization header.

Authorization: ck_your_api_key

Request Parameters

Send these JSON body fields in your request payload.

Name	Type	Description
`url`	string	Public target URL.
`intervalMinutes`	number	Request field.

Example Request

Use direct HTTP requests against the public API base URL.

Example request

1
2
3
4
5
6
7
8
9
10
11
12
13const response = await fetch('https://api.crawlkit.sh/watch', {
  method: 'POST',
  headers: {
    Authorization: 'ck_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "url": "https://example.com",
    "intervalMinutes": 60
  })
});

console.log(await response.json());

Response

Creating a Watch returns its configuration, not a billed check or creditsUsed value. 1 credit per successful check, plus 3 when AI is used. Baseline and unchanged checks are charged. Screenshots included. Unused reservations are refunded.

Success response (200 OK)

1
2
3
4
5
6
7
8
9
10{
  "success": true,
  "requestId": "example-request-id",
  "data": {
    "id": "watch-id",
    "active": true,
    "intervalMinutes": 60,
    "hasBaseline": false
  }
}