Docs · Intelligence
Uptime probe
Is the URL up? Status code, latency, SSL expiry warning. One HEAD (or GET fallback).
POST
/v1/intel/uptime Cheapest possible health check. Sends HEAD; if the site rejects HEAD with 400/403/405, retries with GET. Returns the status code, end-to-end latency, the final URL after following redirects, and (for HTTPS targets) the certificate's expiry date with an early-warning flag when fewer than 14 days remain. Pairs naturally with a cron schedule on your side.
Supported
HEAD probe (with GET fallback), redirect-following, basic SSL expiry check on HTTPS hosts.
Not supported
Not a continuous monitor — call this on your schedule. For true uptime monitoring chain with your existing cron/scheduler.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| url | string | yes | — | URL to probe. |
Request
curl -X POST https://api.qcrawl.com/v1/intel/uptime \
-H "Authorization: Bearer osk_..." \
-d '{"url": "https://qcrawl.com"}'Response
{
"status": "success",
"url": "https://qcrawl.com",
"is_up": true,
"final_status": 200,
"final_url": "https://qcrawl.com/",
"elapsed_ms": 142,
"method_used": "HEAD",
"ssl": {
"valid": true,
"not_after": "2026-08-12T23:59:59+00:00",
"days_remaining": 80,
"issuer_cn": "WE1",
"warning": null
}
}Errors
| Code | Meaning |
|---|---|
| 400 | URL blocked by SSRF guard. |
| 500 | Connection failure or timeout. |