Developer API

Every check on this site as a JSON endpoint. Free plan: 200 requests per day per key.

Get a key

Use it

curl -H "x-api-key: YOUR_KEY" \
  "https://sitedowncheck.com/api/v1/check?url=example.com"

You can also pass ?key=YOUR_KEY. Responses are JSON. Errors return an error field. Results are cached for about 30 seconds.

Quickstart

JavaScript

const res = await fetch('https://sitedowncheck.com/api/v1/check?url=example.com', { headers: { 'x-api-key': process.env.SDC_KEY } });
const data = await res.json();
console.log(data.up, data.status, data.responseTime);

Python

import os, requests
r = requests.get('https://sitedowncheck.com/api/v1/check', params={'url': 'example.com'}, headers={'x-api-key': os.environ['SDC_KEY']}, timeout=30)
print(r.json()['up'])

Example response

{
  "host": "example.com",
  "up": true,
  "status": 200,
  "responseTime": 143,
  "ip": "93.184.216.34",
  "redirects": 1,
  "checkedAt": 1759600000000
}

Newer tools (root-cause, page weight, TLS, CORS and others) return a common shape: verdict with a level of good, warn, bad or info, a title and summary; optional score and grade; sections of checks, tables or lists; and tips.

Errors

Endpoints

Limits

200 requests/day per key (resets at 00:00 UTC). HTTP 429 when exceeded. Private and reserved addresses cannot be checked.