Developers /Monitoring API

Create a draft

Start setting up a monitor: the page is loaded twice in Chrome (a page replica to pick from, then a noise check). Poll the draft until ready.

POST/crawl/v1/monitors/drafts
POST example
curl --request POST \
  --url 'https://factget.dev/crawl/v1/monitors/drafts' \
  --header "Authorization: Bearer $FACTGET_CRAWL_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "https://example.com"
}'

Replace IDs and sample values with your own. Examples are not executed in your browser.

Authorization

Authorizationstring · header · required

Bearer Crawl API key with the required scope. Learn about authentication →

Request body

application/json
urlstringrequired

The public URL to read.

askstring | null
minLength: 1maxLength: 1000
scrapeOptionsobject

How each page is fetched: the scrape options that shape what a run sees.

Show nested properties
onlyMainContentboolean

Return the main page content, excluding common navigation and page furniture.

Default: true
includeTagsstring[] | null

Include the matching HTML elements in the result.

maxItems: 50
excludeTagsstring[] | null

Exclude the matching HTML elements from the result.

maxItems: 50
waitForinteger

Additional time to wait for the page, in milliseconds.

Default: 0minimum: 0maximum: 30000
jsCodestring | null
maxLength: 10000
stepsobject[] | null
maxItems: 10
Show item properties
typestring
Default: "click"
selectorstring | null
minLength: 1maxLength: 2000
xpathstring | null
minLength: 1maxLength: 2000
labelstring | null
maxLength: 200

Responses

200Successful Response
application/json

The published schema does not define individual response fields for this endpoint. Inspect the returned JSON in your integration.

422Validation Error
application/json
detailobject[]
Show item properties
locstring | integer[]required
msgstringrequired
typestringrequired
inputobject
ctxobject

The API schema lists the responses above. Long-running operations can also return 202; see async jobs. For application errors, see errors & retries.