Networking
URL to PDF API
GET request to /v1/url-to-pdf, returning json in the standard envelope.
GET
/v1/url-to-pdf40 credits / call PaidAuthentication
Send your API key as a bearer token. Create one free in the dashboard.
Authorization: Bearer $TOOLSXPO_KEYParameters
Sent as query-string parameters. The values below are the examples used throughout this page.
| Name | Example value |
|---|---|
| url | https://example.com |
Example request
curl "https://api.toolsxpo.com/v1/url-to-pdf?url=https%3A%2F%2Fexample.com" \
-H "Authorization: Bearer $TOOLSXPO_KEY"Response
Every endpoint answers with the same envelope. The result is in data (json); meta.credits reports what the call cost.
{
"ok": true,
"data": { /* json */ },
"meta": { "credits": 40 }
}Errors
Failures use the same envelope with ok: false and a machine-readable code.
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_input | A parameter failed validation. `details` lists which. |
| 401 | unauthorized | Missing or invalid API key. |
| 402 | quota_exceeded | Out of credits on this workspace. |
| 404 | not_found | No such tool. |
| 429 | rate_limited | Too many requests. Retry after `Retry-After` seconds. |
| 503 | service_unavailable | Temporarily disabled by an administrator. |
How to use the URL → PDF API
Render any public page to a print-quality PDF with a real browser (proper CSS, web fonts and @media print rules applied). The PDF comes back base64-encoded in data.base64.
Saving the PDF
Bashcurl "https://api.toolsxpo.com/v1/url-to-pdf?url=https://example.com" \ -H "Authorization: Bearer $TOOLSXPO_KEY" \ | jq -r '.data.base64' | base64 -d > page.pdf
When to use it
- Archiving articles, invoices or receipts as a faithful, self-contained document.
- Generating printable versions of a report page you already render as HTML.
- Snapshotting a page for a compliance or evidence trail.
Tips & gotchas
- Design the page's print styles first — the PDF honours
@media print, so hide nav/ads and set page margins there for the cleanest output. - Content behind auth or requiring interaction won't appear; the browser loads the page as an anonymous visitor.
- Paid tool (runs a real browser). Returns
application/pdfbytes as base64.