Uptime Monitoring API
The Site Detection uptime monitoring API is a token-authenticated REST API that lets you create and manage website monitors in code, pull uptime and response-time data, and integrate website monitoring directly into your own apps, dashboards and workflows.
Alerts for the monitors you create are delivered by email, SMS, Slack, Microsoft Teams, Google Chat, and webhooks.
REST API • Bearer-token auth • Read & write scopes • Per-plan rate limits
What the Uptime Monitoring API Lets You Do
The Site Detection uptime API gives you programmatic access to the same monitoring you would otherwise manage by hand in the dashboard — so you can automate it, script it, and wire it into your own systems.
Manage Monitors in Code
Programmatically create, read, update and delete website monitors, so provisioning and configuration can be driven by your own application instead of manual clicks.
Pull Uptime & Response Data
Retrieve uptime percentages, response-time data, detected incidents and check history for any monitor and use it however your product needs.
Automate Provisioning
Spin up a new monitor automatically when you deploy a new site, and tear it down when it is retired — monitoring that follows your deployment pipeline.
Feed Your Own Dashboards
Read monitoring data through the API and display uptime and response time inside your own status dashboard, admin panel, or internal tooling.
Route Alerts to Webhooks
The monitors you create can alert by email, SMS, Slack, Microsoft Teams, Google Chat, and webhooks, so events can flow into the systems you already use.
Manage Many Sites at Scale
Loop over a list of sites and create or update monitors in bulk, which is ideal for agencies and platforms managing monitoring across many properties.
Looking for the endpoint reference, request and response shapes, and scopes? Head to the API documentation. For the product overview, see our website monitoring service hub.
One Platform, Two Audiences
Site Detection is built to be simple for business owners and powerful for the developers and agencies who want to integrate it. The same monitoring works both ways.
Business Owners
Add a website in the dashboard, let Site Detection watch it around the clock, and get notified when downtime is detected. No code required, and no monitoring software to install. It is straightforward website uptime monitoring for people who just need to know their site is working.
Developers & Agencies
Use the REST API and webhooks to integrate Site Detection into your own systems, dashboards and workflows. Create monitors on deploy, pull uptime and website response-time monitoring data into your product, and connect events to the tools you already run through integrations and webhooks.
A Realistic Uptime API Request
Every request is a normal HTTPS call with a Bearer token. Here is how you would list your monitors and create a new one against the base URL https://sitedetection.com/api/v1.
# List all monitors on your account curl https://sitedetection.com/api/v1/monitors \ -H "Authorization: Bearer sd_live_XXXXXXXXXXXXXXXX" # Create a new monitor for a site you just deployed curl -X POST https://sitedetection.com/api/v1/monitors \ -H "Authorization: Bearer sd_live_XXXXXXXXXXXXXXXX" \ -H "Content-Type: application/json" \ -d '{ "name": "Marketing Site", "url": "https://example.com", "check_interval": 60 }' # Read uptime & response-time data for one monitor curl https://sitedetection.com/api/v1/monitors/mon_123/uptime \ -H "Authorization: Bearer sd_live_XXXXXXXXXXXXXXXX"
The exact fields, endpoints, pagination and response shapes are documented in the API documentation.
Secure by Design
The uptime monitoring API is token-authenticated and scoped, so you can integrate it into production systems with confidence.
Bearer Token Authentication
Each request carries an API token as a Bearer token in the Authorization header. Tokens are stored SHA-256 hashed at rest, so the raw token is not kept on our side.
Read vs. Write Scopes
Issue a read-only token for services that only need to pull uptime and response-time data, or a read/write token for services that also create and manage monitors.
Account-Isolated & Rate-Limited
Tokens only reach your own account and monitors, and requests are subject to per-plan rate limits so the service stays reliable for everyone.
What Developers Build With It
Because the uptime API exposes monitors and monitoring data directly, it fits naturally into a range of real-world integrations.
Agencies
Manage monitoring across many client sites from one place, and provision monitors as you onboard each new client.
SaaS Products
Embed website monitoring inside your own platform so your customers get uptime visibility without you building a monitoring engine.
Provision on Deploy
Wire monitor creation into your deployment pipeline so every new site is monitored the moment it ships.
Status Dashboards
Pull uptime and response-time data into your own internal status dashboard or customer-facing view.
Ready to Integrate Uptime Monitoring?
Create an account, generate an API token, and start creating monitors and reading uptime data from your own code. The full endpoint reference, scopes and examples are in the documentation.
Read the full API documentationUptime Monitoring API FAQ
What is an uptime monitoring API?
An uptime monitoring API is a programmatic interface that lets you create and manage website monitors and read monitoring data with code instead of only using a dashboard. Site Detection's REST API lets you create, read, update and delete monitors and pull uptime percentages, response-time data, incidents and check history so you can build website monitoring into your own applications and workflows.
How do I authenticate with the Site Detection API?
The Site Detection API uses token authentication. You send an API token as a Bearer token in the Authorization header of each request. Tokens are stored SHA-256 hashed at rest, can be scoped for read-only or read/write access, and are isolated to your own account and monitors.
What can I do with the Site Detection API?
You can programmatically create, read, update and delete website monitors, retrieve uptime percentages, response-time data, incidents and check history, and automate provisioning such as spinning up a monitor when you deploy a new site. That makes it possible to embed monitoring in your own product, pull uptime into your own status dashboard, and manage monitoring across many client sites.
Which plans include API access?
API access is available on eligible Site Detection plans. See the pricing page for current plan details, and the API documentation for the endpoints and scopes available to your account.
Is there rate limiting on the API?
Yes. The Site Detection API applies per-plan rate limits so the service stays reliable for everyone. Requests are counted per token, and the applicable limits depend on your plan. The API documentation describes the current limits and how to work within them.