Monitors

Monitor a web page for changes

Create a scheduled web-change monitor whose detected changes arrive as an ordinary followed source — query, watch, and mutate it like any feed. Naming a collection that does not exist creates it. Active monitor limits are Free 3, Patron 10, and Pro 100; scheduled monthly credits are 150, 720, and 7,200, respectively. Page and sitemap runs reserve 1 credit; extract runs reserve 10. The shortest interval is 60 minutes and the default schedule is daily. The response reports remaining slots and scheduled credits.

POST

https://api.smry.ai

feeds

monitors

Monitor a web page for changes

curl --request POST \
  --url https://api.smry.ai/v1/feeds/monitors \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Example page changes",
  "target": {
    "type": "page",
    "url": "https://example.com"
  }
}
'

import requests

url = "https://api.smry.ai/v1/feeds/monitors"

payload = {
    "name": "Example page changes",
    "target": {
        "type": "page",
        "url": "https://example.com"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Example page changes',
    target: {type: 'page', url: 'https://example.com'}
  })
};

fetch('https://api.smry.ai/v1/feeds/monitors', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "monitor": {},
  "subscription": {},
  "limits": {}
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

Authorizations

Authorization

string

header

required

Clerk OAuth 2.0 Authorization Code flow with PKCE. Request the minimum scope required by the operation.

Body

application/json

name

string

required

Required string length: 1 - 200

target

object

required

"page" watches one URL, "sitemap" watches URL additions/removals, "extract" watches for meaningful site-wide changes per your instructions.

Option 1
Option 2
Option 3

Hide child attributes

target.type

string

required

Allowed value: "page"

target.url

string

required

A public http(s) URL.

Required string length: 8 - 2048

target.instructions

string

Required string length: 1 - 2000

target.normalize_whitespace

boolean

collection

Collection id or name. A new name is created. Omit for Unsorted.

Required range: x >= 1

change_detection

object

Option 1
Option 2

Hide child attributes

change_detection.type

string

required

Allowed value: "exact"

schedule

object

Default: daily. Shortest interval: 60 minutes.

Option 1
Option 2
Option 3

Hide child attributes

schedule.type

string

required

Allowed value: "interval"

schedule.frequency

integer

required

Required range: 60 <= x <= 43200

schedule.unit

string

required

Allowed value: "minutes"

Response

Monitor a web page for changes. The operation succeeded.

monitor

object

required

subscription

object

required

limits

object

required

Last modified on September 13, 2026

Monitor a web page for changes

curl --request POST \
  --url https://api.smry.ai/v1/feeds/monitors \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Example page changes",
  "target": {
    "type": "page",
    "url": "https://example.com"
  }
}
'

import requests

url = "https://api.smry.ai/v1/feeds/monitors"

payload = {
    "name": "Example page changes",
    "target": {
        "type": "page",
        "url": "https://example.com"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Example page changes',
    target: {type: 'page', url: 'https://example.com'}
  })
};

fetch('https://api.smry.ai/v1/feeds/monitors', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "monitor": {},
  "subscription": {},
  "limits": {}
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

Overview

Account

Articles

Library

Feeds

Collections

Consumers

Monitors

Monitor a web page for changes

Authorizations

Body

Response