API Documentation

API di Conversione File EnConvert#

EnConvert è un'API REST di conversione file per convertire documenti, immagini, formati dati e pagine web tra formati diversi, ad esempio per trasformare un URL in un PDF tramite /v1/convert/url-to-pdf. Offre agli sviluppatori accesso programmatico a 51 endpoint di conversione più sei endpoint V2 di web intelligence, senza dover gestire l'infrastruttura di conversione. Le richieste vengono eseguite in modalità sincrona o asincrona, e l'elaborazione batch converte più file o URL in un'unica richiesta.

Beta: L'API EnConvert è attualmente in beta. Endpoint, parametri e formati di risposta possono cambiare mentre perfezioniamo la piattaforma in base al feedback degli sviluppatori. Ti consigliamo di ancorarti a un comportamento specifico invece di affidarti a campi non documentati.

URL di base:

https://api.enconvert.com

Tutte le richieste API devono essere effettuate a questo URL di base, seguito dal percorso dell'endpoint appropriato (ad es., https://api.enconvert.com/v1/convert/url-to-pdf).

Funzionalità principali#

  • 51 endpoint di conversione che coprono documenti, formati dati, immagini e pagine web
  • Web intelligence (V2, beta): percepisci, scopri, cerca, estrai, ingerisci e monitora pagine web attraverso sei endpoint /v2, tutti già chiamabili oggi
  • Due metodi di autenticazione: chiavi private per integrazioni server-to-server e chiavi pubbliche con JWT per l'uso lato client
  • Elaborazione batch: converti più file o URL in un'unica richiesta
  • Modalità sincrona e asincrona: ottieni risultati immediati oppure esegui il polling per il completamento su job di lunga durata
  • Notifiche job: ricevi callback webhook al completamento delle conversioni asincrone
  • Widget web: integra la funzionalità di conversione direttamente nella tua applicazione web
  • Nessun SDK richiesto: usa richieste HTTP standard da qualsiasi linguaggio o piattaforma

Conversioni supportate#

Pagine web#

Conversione Endpoint
URL in PDF /v1/convert/url-to-pdf
URL in Screenshot /v1/convert/url-to-screenshot
URL in Markdown /v1/convert/url-to-markdown
Sito web in PDF /v1/convert/website-to-pdf
Sito web in Screenshot /v1/convert/website-to-screenshot

Formati dati#

Conversione Endpoint
JSON in XML /v1/convert/json-to-xml
XML in JSON /v1/convert/xml-to-json
JSON in YAML /v1/convert/json-to-yaml
YAML in JSON /v1/convert/yaml-to-json
JSON in CSV /v1/convert/json-to-csv
CSV in JSON /v1/convert/csv-to-json
JSON in TOML /v1/convert/json-to-toml
TOML in JSON /v1/convert/toml-to-json
CSV in XML /v1/convert/csv-to-xml
XML in CSV /v1/convert/xml-to-csv
Markdown in HTML /v1/convert/markdown-to-html

Documenti in PDF#

Conversione Endpoint
HTML in PDF /v1/convert/html-to-pdf
Markdown in PDF /v1/convert/markdown-to-pdf
Word in PDF /v1/convert/doc-to-pdf
Excel in PDF /v1/convert/excel-to-pdf
PowerPoint in PDF /v1/convert/ppt-to-pdf
Pages in PDF /v1/convert/pages-to-pdf
Numbers in PDF /v1/convert/numbers-to-pdf
ODT in PDF /v1/convert/odt-to-pdf
ODS in PDF /v1/convert/ods-to-pdf
ODP in PDF /v1/convert/odp-to-pdf
OTS in PDF /v1/convert/ots-to-pdf
Qualsiasi documento in PDF /v1/convert/anything-to-pdf
Qualsiasi documento in Markdown /v1/convert/anything-to-markdown

Conversioni di immagini#

Conversione Endpoint
JPEG in PNG /v1/convert/jpeg-to-png
PNG in JPEG /v1/convert/png-to-jpeg
JPEG in SVG /v1/convert/jpeg-to-svg
SVG in JPEG /v1/convert/svg-to-jpeg
JPEG in HEIC /v1/convert/jpeg-to-heic
HEIC in JPEG /v1/convert/heic-to-jpeg
JPEG in WebP /v1/convert/jpeg-to-webp
WebP in JPEG /v1/convert/webp-to-jpeg
PNG in SVG /v1/convert/png-to-svg
SVG in PNG /v1/convert/svg-to-png
PNG in HEIC /v1/convert/png-to-heic
HEIC in PNG /v1/convert/heic-to-png
PNG in WebP /v1/convert/png-to-webp
WebP in PNG /v1/convert/webp-to-png
SVG in HEIC /v1/convert/svg-to-heic
HEIC in SVG /v1/convert/heic-to-svg
SVG in WebP /v1/convert/svg-to-webp
WebP in SVG /v1/convert/webp-to-svg
HEIC in WebP /v1/convert/heic-to-webp
WebP in HEIC /v1/convert/webp-to-heic
PDF in JPEG /v1/convert/pdf-to-jpeg
Comprimi un'immagine /v1/convert/compress-image

Web intelligence (V2)#

Gli endpoint V2 trasformano un URL in qualcosa che un'applicazione può utilizzare: Markdown pulito, dati strutturati, un set di risultati di ricerca, chunk pronti per RAG, o un avviso di modifica. Funzionano sullo stesso motore Chrome headless e con le stesse chiavi API degli endpoint di conversione, attingono dalla stessa quota mensile unificata di ops e hanno un proprio stato beta.

Endpoint Cosa fa
/v2/perceive Esegue il rendering di un URL una sola volta e restituisce Markdown, HTML, uno screenshot, un PDF, link e dati strutturati da quel singolo rendering.
/v2/discover Enumera gli URL di un sito a partire dalla sua sitemap e da una scansione HTTP, senza eseguire il rendering di ogni pagina.
/v2/lookup Esegue una ricerca web, news, scholar o maps e, opzionalmente, percepisce i risultati migliori.
/v2/distill Estrae dati corrispondenti a uno schema JSON, con un passaggio CSS gratuito e un fallback assistito da LLM.
/v2/ingest Esegue la scansione di un sito in chunk pronti per RAG e in un file JSONL, consegnati in modo asincrono.
/v2/watch Monitora un URL per rilevare modifiche e ti notifica via webhook o email quando cambia.

Tutti e sei sono richiamabili già oggi con la stessa chiave. Perceive e Ingest sono disponibili in generale; Distill, Lookup, Watch e Discover sono in beta privata, quindi le loro forme di richiesta e risposta possono cambiare senza preavviso e le loro pagine restano sotto Coming Soon.

Una quota unificata: Le conversioni V1 e le operazioni V2 attingono da un'unica quota mensile di ops. Ogni unità di lavoro costa una op: una conversione di file, un URL sottoposto a perceive o distill, una pagina ingerita, una query di lookup, una chiamata a discover. Nessun moltiplicatore di crediti, nessun contatore per endpoint. Quote per livello: Founding 500, Indie 3.000, Studio 15.000, Production 50.000 ops al mese (Enterprise su misura). I watcher hanno un tetto separato, e l'estrazione LLM attinge da crediti AI mensili anziché dalle ops. Consulta la panoramica V2 e la pagina dei prezzi.

Domande frequenti#

Quali formati di file posso convertire con l'API di conversione file di EnConvert?#

L'API espone 51 endpoint di conversione suddivisi in quattro categorie: pagine web (URL in PDF, screenshot o Markdown), formati dati (JSON, XML, YAML, CSV, TOML, Markdown, HTML), documenti in PDF (Word, Excel, PowerPoint, Pages, Numbers e formati OpenDocument) e conversioni di immagini (JPEG, PNG, SVG, HEIC, WebP).

Ho bisogno di un SDK per usare l'API di conversione file?#

No. EnConvert non richiede alcun SDK: effettui richieste HTTP standard da qualsiasi linguaggio o piattaforma verso l'URL di base https://api.enconvert.com, seguito dal percorso dell'endpoint come /v1/convert/url-to-pdf.

L'API supporta la conversione file asincrona?#

Sì. L'API offre modalità sincrona e asincrona: ottieni risultati immediati oppure esegui il polling per il completamento su job di lunga durata. Inoltre, le notifiche job inviano callback webhook al completamento delle conversioni asincrone.

Come mi autentico con l'API EnConvert?#

Sono supportati due metodi di autenticazione: chiavi private per l'integrazione server-to-server e chiavi pubbliche con JWT per l'uso lato client.

Dove proseguire#

  • La Guida rapida mette in funzione una prima conversione con cURL, Python o Node.js.
  • I Concetti spiegano le superfici di accesso, i job sincroni e asincroni, gli URL di output firmati e le differenze tra V1 e V2.
  • Gli Endpoint sono il riferimento per Perceive, Ingest e ogni rotta di conversione, oltre ai parametri di richiesta che condividono.
  • Le Guide coprono l'ingestione dei file, i webhook, l'elaborazione batch e le integrazioni: MCP, n8n, la CLI e gli SDK.
Quickstart →