---
seo_title: API Pagine Web: PDF, Screenshot, Markdown | EnConvert
meta_desc: Converti pagine web live con l'API EnConvert: URL in PDF, screenshot a pagina intera, Markdown pronto per LLM e scansioni di interi siti in PDF o PNG come ZIP.
keywords: api conversione url, api cattura pagina web, api url in pdf, api screenshot sito web, api url in markdown, api scansione sito in pdf, api screenshot pagina intera, convertire pagina web in markdown per llm
---

# API di Conversione Pagine Web

Gli endpoint delle pagine web renderizzano URL live in un browser reale e li convertono in PDF, screenshot PNG a pagina intera, o Markdown pulito in formato GitHub-Flavored. Gli endpoint a URL singolo vengono eseguiti in modo sincrono (o asincrono in batch), mentre gli endpoint website scansionano un intero sito (tramite parsing della sitemap o una scansione completa in ampiezza) e raggruppano ogni pagina in un unico archivio ZIP. Tutti gli endpoint condividono la stessa pipeline del browser: chiusura dei banner dei cookie, scroll per il lazy-load, gestione degli header sticky, e supporto per pagine protette da HTTP Basic Auth, cookie iniettati o header personalizzati.

## Conversioni supportate

| Conversione | Endpoint | Descrizione |
|-----------|----------|-------------|
| [URL in PDF](/it/docs/endpoints/convert/web-pages/url-to-pdf.md) | `POST /v1/convert/url-to-pdf` | Converte qualsiasi URL pubblicamente accessibile in un PDF ad alta fedeltà, con output a pagina singola continua o paginato, dimensioni di pagina personalizzate, intestazioni/piè di pagina e modalità batch asincrona. |
| [URL in Screenshot](/it/docs/endpoints/convert/web-pages/url-to-screenshot.md) | `POST /v1/convert/url-to-screenshot` | Cattura uno screenshot a pagina intera di qualsiasi URL come PNG ad alta fedeltà, ridimensionando il viewport all'altezza reale del contenuto in modo che l'intera pagina sia in un'unica immagine. |
| [URL in Markdown](/it/docs/endpoints/convert/web-pages/url-to-markdown.md) | `POST /v1/convert/url-to-markdown` | Converte una pagina web in Markdown pulito in formato GitHub-Flavored con frontmatter YAML, usando l'estrazione Readability per rimuovere il boilerplate. È pensato per pipeline di ingestione LLM e RAG. |
| [Website in PDF](/it/docs/endpoints/convert/web-pages/website-to-pdf.md) | `POST /v1/convert/website-to-pdf` | Scansiona un intero sito web tramite sitemap o scansione completa in ampiezza, converte ogni pagina individuata in PDF e raggruppa i risultati in un unico archivio ZIP. |
| [Website in Screenshot](/it/docs/endpoints/convert/web-pages/website-to-screenshot.md) | `POST /v1/convert/website-to-screenshot` | Individua ogni pagina di un sito web tramite sitemap o scansione completa e cattura un PNG a pagina intera di ciascuna, consegnati come un unico archivio ZIP. |

## Convenzioni condivise

- **Autenticazione:** ogni endpoint accetta una chiave privata nell'header `X-API-Key`; i tre endpoint a URL singolo accettano anche token JWT Bearer a chiave pubblica (limitati a un singolo URL, modalità sincrona e download diretto), mentre gli endpoint website richiedono una chiave privata. Consulta [Autenticazione](/it/docs/authentication.md).
- **Sincrono vs asincrono:** gli endpoint a URL singolo vengono eseguiti in modo sincrono per impostazione predefinita e passano ad asincrono (`async_mode=true`, HTTP 202 con un `batch_id`) per i batch; gli endpoint website sono sempre asincroni. Esegui il polling di `GET /v1/convert/batch/{batch_id}` per i risultati. Consulta [Job sync e async](/it/docs/concepts/sync-and-async.md).
- **Risposte:** le conversioni completate restituiscono un URL di download presigned e `object_key`; gli endpoint a URL singolo possono invece restituire i byte grezzi dell'output con `direct_download=true`.
- **Parametri del browser e del rendering:** `viewport_width`/`viewport_height`, `handle_cookies`, `enable_scroll`, `load_media`, `wait_for_images` e `handle_sticky_header` sono condivisi su tutti e cinque gli endpoint, così come le opzioni `auth`, `cookies` (max 50) e `headers` (max 20) per le pagine protette. Consulta [Job sync e async](/it/docs/concepts/sync-and-async.md).
- **Errori e limitazioni di piano:** tutti gli endpoint usano gli stessi codici di stato: `400` per input non valido, `401` per credenziali errate, `402` per limiti di quota o storage, e `403` per funzionalità limitate dal piano (async, webhook, output ZIP, basic auth, cattura di siti web). Consulta [Codici di Errore](/it/docs/reference/errors.md).

## Domande frequenti

### Quale endpoint dovrei usare per una singola pagina rispetto a un intero sito web?

Usa [url-to-pdf](/it/docs/endpoints/convert/web-pages/url-to-pdf.md), [url-to-screenshot](/it/docs/endpoints/convert/web-pages/url-to-screenshot.md) o [url-to-markdown](/it/docs/endpoints/convert/web-pages/url-to-markdown.md) per un singolo URL o un elenco esplicito di URL. Usa [website-to-pdf](/it/docs/endpoints/convert/web-pages/website-to-pdf.md) o [website-to-screenshot](/it/docs/endpoints/convert/web-pages/website-to-screenshot.md) quando vuoi che sia l'API a individuare le pagine tramite parsing di `sitemap.xml` o una scansione completa in ampiezza e a restituire tutto come un unico ZIP.

### Questi endpoint possono convertire pagine protette da login?

Sì, sui piani con accesso al basic auth. Tutti e cinque gli endpoint accettano un oggetto `auth` per l'HTTP Basic Auth, fino a 50 `cookies` iniettati per l'accesso basato su sessione, e fino a 20 `headers` personalizzati. Queste opzioni sono utili per siti di staging, pagine riservate ai membri e dashboard.

### Come ottengo il risultato di un job asincrono?

I job asincroni restituiscono immediatamente HTTP 202 con un `batch_id`. Esegui il polling di `GET /v1/convert/batch/{batch_id}` con la tua chiave privata per gli stati per-URL e gli URL di download presigned, fornisci un `callback_url` per ricevere un POST webhook al completamento, oppure affidati all'email di completamento inviata a `notification_email` (il proprietario del progetto per impostazione predefinita).