REST API Reference

Submit URL-checking jobs over JSON, poll for completion, fetch paginated results. Standard bearer-token auth, OpenAPI spec published, five endpoints. Same backend as the web UI and the MCP integration.

Create API key →OpenAPI spec Want MCP instead? →

Authentication

Every request must carry an Authorization: Bearer uck_live_YOUR_KEY header. Generate a key from the dashboard — we show the plaintext value once, then store only an irreversible hash. Lose it and you regenerate, no recovery.

Quickstart

1curl -X POST https://api.bulkurlchecker.com/api/v2/jobs \
2  -H "Authorization: Bearer uck_live_YOUR_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{"urls": ["https://example.com", "https://example.org"]}'

Endpoints

Method	Path	Description
POST	/api/v2/jobs	Submit URLs. Returns job_id.
GET	/api/v2/jobs/{id}	Status + progress.
GET	/api/v2/jobs/{id}/results	Paginated results (limit, offset).
DELETE	/api/v2/jobs/{id}	Cancel + refund unchecked credits.
GET	/api/v2/usage	Current credit balance.

POST/api/v2/jobs
Submit URLs. Returns job_id.
GET/api/v2/jobs/{id}
Status + progress.
GET/api/v2/jobs/{id}/results
Paginated results (limit, offset).
DELETE/api/v2/jobs/{id}
Cancel + refund unchecked credits.
GET/api/v2/usage
Current credit balance.

Full request/response schemas, error codes, and examples are in the OpenAPI spec. Drop it into Postman, Stoplight, or the SDK generator of your choice.

Rate limits

60 requests per minute per key (burst).
10,000 requests per day per key (soft cap).
Exceed a limit and you get HTTP 429 with a Retry-After header. Back off and retry.
Need higher limits for production workloads? Reach out and we'll tune per key.

Pricing

One credit per URL checked. New accounts get a free tier on signup; additional credits are pay-as-you-go through billing. Cancelling a job mid-run refunds unchecked credits. The REST API and the MCP integration share the same balance — no separate quota.

Create API key →MCP integration →