Bulk URL Status Checker

Endpoint

POST https://www.urlchecker.alfra.si/index.php?api=1

The same file serves the UI and the API. When ?api=1 is present (or Accept: application/json header is sent), the file returns JSON instead of HTML.

Authentication

Two options — use whichever fits your client:

# Option 1: Authorization header (recommended) Authorization: Bearer YOUR_API_KEY_HERE # Option 2: query parameter (simpler, less secure) https://www.urlchecker.alfra.si/index.php?api=1&key=YOUR_API_KEY_HERE

Request

POST https://www.urlchecker.alfra.si/index.php?api=1 Content-Type: application/json Authorization: Bearer YOUR_API_KEY_HERE { "urls": [ "https://example.com", "https://example.com/missing-page", "https://httpstat.us/503" ] }

Response

{ "results": [ { "url": "https://example.com", "status": 200, // 0 = connection failed entirely "message": "OK", "final_url": "https://www.example.com/", // after redirects "time_ms": 312 }, { "url": "https://example.com/missing-page", "status": 404, "message": "Not Found", "final_url": "https://example.com/missing-page", "time_ms": 289 } ], "stats": { "total": 3, "ok": 1, "redirect": 0, "client_err": 1, "server_err": 1, "failed": 0 } }

cURL Example

curl -s -X POST \ "https://www.urlchecker.alfra.si/index.php?api=1" \ -H "Authorization: Bearer YOUR_API_KEY_HERE" \ -H "Content-Type: application/json" \ -d '{"urls":["https://example.com","https://example.com/404"]}'

How to Use With Claude (AI)

Tell Claude about your endpoint at the start of a conversation. Claude can then call it using a fetch-based artifact:

// Paste this into your Claude conversation: I have a URL checker API: Endpoint: https://www.urlchecker.alfra.si/index.php?api=1 Method: POST Header: Authorization: Bearer YOUR_API_KEY_HERE Body: {"urls": [...]} Please check these URLs and summarise any errors: https://mysite.com/page-1 https://mysite.com/page-2 https://mysite.com/old-link

Limits & Configuration

Setting	Value	To change
Max URLs / API call	100	Edit `MAX_API_URLS`
Max URLs / UI upload	500	Edit `MAX_URLS`
Timeout / URL	15s	Edit `CURL_TIMEOUT`
Max file size	5 MB	Edit `MAX_FILE_SIZE`
CORS origin	*	Edit `ALLOWED_ORIGINS`
status = 0	integer	Means total connection failure (DNS, TLS, timeout)