ToolsXpo

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 Paid

Authentication

Send your API key as a bearer token. Create one free in the dashboard.

Authorization: Bearer $TOOLSXPO_KEY

Parameters

Sent as query-string parameters. The values below are the examples used throughout this page.

NameExample value
urlhttps://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.

StatusCodeMeaning
400invalid_inputA parameter failed validation. `details` lists which.
401unauthorizedMissing or invalid API key.
402quota_exceededOut of credits on this workspace.
404not_foundNo such tool.
429rate_limitedToo many requests. Retry after `Retry-After` seconds.
503service_unavailableTemporarily 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

Bash
curl "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/pdf bytes as base64.