Skip to main content

PDF Tools API

Página web para PDF API

Coloque converter páginas web para PDF no backend, em lotes ou no seu produto sem manter infraestrutura própria de PDF.

Credits

1 Credit / call

1 Credit per successful API request. Failed processing attempts are refunded automatically.

Pricing

1,000 Credits = $1

Every signed-in user receives 100 free API Credits each month.

Endpoint

/api/external/webpage-to-pdf/pdf

Use your API Key in the x-api-key header.

Use case

Use para capturar páginas públicas, exports de clientes ou provas online agendadas. A ferramenta web serve para revisão manual; a API serve para automação repetível no servidor.

cURL example

curl -X POST https://itextmaster.com/api/external/webpage-to-pdf/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'url=https://example.com/report' \
  -F 'pageSize=A4' \
  -F 'waitDelay=2' \
  --output webpage.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/webpage-to-pdf/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'url=https://example.com/report' \
  -F 'pageSize=A4' \
  -F 'waitDelay=2' \
  --output webpage.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/webpage-to-pdf/pdf \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "url": "https://example.com/report",
    "pageSize": "A4",
    "waitDelay": 2
  }' \
  --output webpage.pdf

Node.js example

import { writeFile } from 'node:fs/promises';

const response = await fetch('https://itextmaster.com/api/external/webpage-to-pdf/pdf', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ITEXTMASTER_API_KEY
  },
  body: JSON.stringify({
  url: 'https://example.com/report',
  pageSize: 'A4',
  waitDelay: 2
})
});

if (!response.ok) {
  throw new Error(await response.text());
}

await writeFile('webpage.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/webpage-to-pdf/pdf',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'url': 'https://example.com/report',
        'pageSize': 'A4',
        'waitDelay': 2,
    },
)
response.raise_for_status()

with open('webpage.pdf', 'wb') as f:
    f.write(response.content)

Error codes

400invalid_payload

O JSON ou multipart não contém HTML, URL ou arquivo obrigatório.

401invalid_api_key

O x-api-key está ausente, inválido ou foi rotacionado.

402insufficient_credits

A conta não tem API Credits suficientes.

502conversion_failed

A renderização no servidor não concluiu a conversão. Credits são devolvidos automaticamente quando falha.

Limits

  • Precisa de um PDF válido ou dados de entrada corretos.
  • Chame a API pelo servidor para não expor a API Key no navegador.
  • Teste arquivos representativos antes de processar grandes lotes.

Response headers

webpage.pdf com cabeçalhos de Credits consumidos e saldo restante.

Content-Type
Tipo MIME do arquivo gerado, normalmente application/pdf ou application/zip.
Content-Disposition
Nome de download do arquivo gerado.
X-Credits-Charged
Credits cobrados pela solicitação bem-sucedida.
X-Credit-Balance
Saldo de API Credits após a solicitação.

FAQ

Quanto custa Página web para PDF API?

Solicitações bem-sucedidas usam API Credits; falhas de processamento são devolvidas automaticamente. Usuários logados recebem 100 free API Credits por mês, e 1,000 Credits = $1.

As ferramentas web usam API Credits?

Não. Ferramentas que rodam no navegador não consomem API Credits. Só chamadas com API Key entram na cobrança.

Posso chamar a API pelo navegador?

Não é recomendado. Guarde a API Key no backend, fila ou automação do servidor.

Start with 100 free API Credits

Create an API Key, test Página web para PDF API, and buy more Credits only when automation volume grows.