Skip to main content

List Monitors

Retrieve all monitors for your account.

Endpoint

GET /v1/monitoring

Query Parameters

ParameterTypeRequiredDescription
statusstringNoFilter by status: active, paused, error
pageintegerNoPage number (default: 1)
limitintegerNoItems per page (default: 20, max: 100)

Example Request

curl -X GET "https://api.scrapebit.com/v1/monitoring?status=active&page=1&limit=20" \
-H "Authorization: Bearer YOUR_API_KEY"

Response

{
"success": true,
"data": [
{
"id": "mon_abc123",
"name": "Product Price Monitor",
"url": "https://shop.example.com/product/123",
"monitorType": "selector",
"selector": ".product-price",
"checkInterval": "hourly",
"status": "active",
"lastCheckAt": "2025-02-01T14:00:00Z",
"nextCheckAt": "2025-02-01T15:00:00Z",
"consecutiveErrors": 0,
"notifyOnlyOnChanges": true,
"alertChannels": [
{
"id": "ch_xyz789",
"type": "email",
"email": "alerts@example.com",
"isEnabled": true
}
],
"_count": {
"checks": 48,
"alerts": 3
}
},
{
"id": "mon_def456",
"name": "Competitor Homepage",
"url": "https://competitor.example.com",
"monitorType": "full_page",
"checkInterval": "daily",
"status": "active",
"lastCheckAt": "2025-02-01T09:00:00Z",
"nextCheckAt": "2025-02-02T09:00:00Z",
"consecutiveErrors": 0,
"notifyOnlyOnChanges": true,
"alertChannels": [],
"_count": {
"checks": 7,
"alerts": 1
}
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 2,
"totalPages": 1
}
}

Try It Out

GET/v1/monitoring

List all your monitors

Your API key is stored locally in your browser