API docs

One endpoint. Authenticate with the X-API-Key header (create keys in your dashboard).

Quickstart

POST https://api.pageloadr.com/v1/fetch

curl -X POST https://api.pageloadr.com/v1/fetch \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Request body

Field	Type	Description
url	string (required)	Public http(s) URL to load.
wait_for_selector	string	CSS selector to wait for before returning.
wait_ms	int 0–30000	Extra wait after load, in milliseconds.
timeout_s	number ≤ 300	Overall timeout for the request.

Response

request_id: Unique ID for support/debugging
url / final_url: Requested and final (post-redirect) URL
status: HTTP status of the target page
blocked: Whether the attempt looked blocked
html: Rendered HTML
attempts: Attempts made (failed ones are free)
elapsed_ms: Total time
error: Error message, if any

Billing rule

Only HTTP 200 responses cost a credit. Blocked requests, timeouts, non-200 statuses and internal errors are free and still appear in your usage log.

Errors

401 invalid or revoked key
402 out of credits
422 invalid request body
429 rate limited / concurrency exceeded