PDF Tools API

API per modificare metadati PDF

Integra modificare metadati PDF nel backend, nei batch o nel prodotto senza mantenere un servizio PDF proprietario.

Create API Key Read full API docs

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/pdf-tools/edit-metadata

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

Use case

Usalo per normalizzare titolo, autore e parole chiave di documenti generati o archiviati. Lo strumento web è per revisione manuale; l’API è per automazioni ripetibili lato server.

cURL example

curl -X POST https://itextmaster.com/api/external/pdf-tools/edit-metadata \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'file=@input.pdf;type=application/pdf' \
  -F 'options={"title":"Updated title","author":"iTextMaster","subject":"API generated document"}' \
  --output metadata-updated.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/pdf-tools/edit-metadata \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'file=@input.pdf;type=application/pdf' \
  -F 'options={"title":"Updated title","author":"iTextMaster","subject":"API generated document"}' \
  --output metadata-updated.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/pdf-tools/edit-metadata \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "file": { "name": "input.pdf", "dataBase64": "JVBERi0xLjcK..." },
    "options": {"title":"Updated title","author":"iTextMaster","subject":"API generated document"}
  }' \
  --output metadata-updated.pdf

Node.js example

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

const response = await fetch('https://itextmaster.com/api/external/pdf-tools/edit-metadata', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ITEXTMASTER_API_KEY
  },
  body: JSON.stringify({
  file: { name: 'input.pdf', dataBase64: 'JVBERi0xLjcK...' },
  options: {"title":"Updated title","author":"iTextMaster","subject":"API generated document"}
})
});

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

await writeFile('metadata-updated.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/pdf-tools/edit-metadata',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'file': {'name': 'input.pdf', 'dataBase64': 'JVBERi0xLjcK...'},
        'options': {'title': 'Updated title', 'author': 'iTextMaster', 'subject': 'API generated document'}
    },
)
response.raise_for_status()

with open('metadata-updated.pdf', 'wb') as f:
    f.write(response.content)

Error codes

401invalid_api_key

L’header x-api-key manca, non è valido o è stato ruotato.

402insufficient_credits

L’account non ha API Credits sufficienti.

422pdf_tool_processing_failed

File, opzioni o struttura PDF non sono stati elaborati. I Credits vengono restituiti automaticamente in caso di errore.

Limits

Serve un PDF valido o dati di input corretti.
Chiama l’API dal server per non esporre la API Key nel browser.
Prova file rappresentativi prima di elaborare grandi lotti.

Response headers

metadata-updated.pdf con header che indicano Credits usati e saldo rimanente.

Content-Type: Tipo MIME del file generato, di solito application/pdf o application/zip.
Content-Disposition: Nome di download del file generato.
X-Credits-Charged: Credits addebitati per la richiesta riuscita.
X-Credit-Balance: Saldo API Credits dopo la richiesta.

FAQ

Quanto costa API per modificare metadati PDF?

Le richieste riuscite usano API Credits; gli errori di elaborazione vengono rimborsati automaticamente. Ogni utente con accesso riceve 100 free API Credits al mese, e 1,000 Credits = $1.

Gli strumenti web usano API Credits?

No. Gli strumenti che lavorano nel browser non consumano API Credits. Contano solo le chiamate con API Key.

Posso chiamare l’API dal browser?

Non è consigliato. Tieni la API Key nel backend, in una coda o in un job lato server.

Start with 100 free API Credits

Create an API Key, test API per modificare metadati PDF, and buy more Credits only when automation volume grows.

Get API Key View full API docs