API Documentation

Authentication

Pass your API key via the x-api-key header or key query parameter.

curl "https://cronping.grabshot.dev/v1/monitors" \
  -H "x-api-key: crp_your_api_key_here"

One-Off Ping

Quick check if a URL is up. Works without auth for demo purposes.

Parameters

Example

curl "https://cronping.grabshot.dev/v1/ping?url=https://google.com"

Response

{
  "success": true,
  "is_up": true,
  "status_code": 200,
  "response_time_ms": 142,
  "url": "https://google.com",
  "headers": { "content-type": "text/html; charset=UTF-8", ... }
}

Create Monitor

Body Parameters

curl

curl -X POST "https://cronping.grabshot.dev/v1/monitors" \
  -H "x-api-key: crp_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "interval": 300,
    "webhook_url": "https://hooks.slack.com/...",
    "name": "My Website"
  }'

Node.js

const res = await fetch('https://cronping.grabshot.dev/v1/monitors', {
  method: 'POST',
  headers: {
    'x-api-key': 'crp_your_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://example.com',
    interval: 300,
    webhook_url: 'https://hooks.slack.com/...'
  })
});
const data = await res.json();

Python

import requests

res = requests.post(
    'https://cronping.grabshot.dev/v1/monitors',
    headers={'x-api-key': 'crp_your_key'},
    json={
        'url': 'https://example.com',
        'interval': 300,
        'webhook_url': 'https://hooks.slack.com/...'
    }
)
data = res.json()

List Monitors

curl "https://cronping.grabshot.dev/v1/monitors" \
  -H "x-api-key: crp_your_key"

Monitor History

curl "https://cronping.grabshot.dev/v1/monitors/1/history?limit=50" \
  -H "x-api-key: crp_your_key"

Response

{
  "success": true,
  "monitor": { "id": 1, "url": "https://example.com", "name": "My Website", "status": "up" },
  "uptime_percent": 99.85,
  "avg_response_time_ms": 234,
  "history": [
    { "status_code": 200, "response_time_ms": 142, "is_up": 1, "error": null, "created_at": "2026-02-18T..." },
    ...
  ],
  "count": 50
}

Delete Monitor

curl -X DELETE "https://cronping.grabshot.dev/v1/monitors/1" \
  -H "x-api-key: crp_your_key"

Webhook Payload

When a monitor goes down (after 3 consecutive failures) or recovers, CronPing sends a POST to your webhook URL:

{
  "event": "monitor.down",
  "monitor": {
    "id": 1,
    "url": "https://example.com",
    "name": "My Website"
  },
  "result": {
    "status_code": null,
    "response_time_ms": 10000,
    "error": "Timeout after 10000ms"
  },
  "timestamp": "2026-02-18T01:23:45.678Z"
}

Events: monitor.down and monitor.up

Plans & Limits

Account & Keys