Questa pagina è disponibile anche in English
REST API ufficiale

Una sola API HTTP. Ogni conversione, una sola base URL.

Quarantanove endpoint di conversione per pagine web, formati dati, documenti e immagini, più sei endpoint di web intelligence che renderizzano, cercano, estraggono e monitorano pagine live. Tutto passa da api.enconvert.com, e ogni conversione risponde con un link di download prefirmato.

curl -X POST https://api.enconvert.com/v1/convert/url-to-pdf -H "X-API-Key: sk_..." -d '{"url":"https://example.com"}'
Autenticazione

Due tipi di key, a un header di distanza.

Scegli la key che corrisponde alla provenienza della richiesta. Entrambe si creano e revocano dalla dashboard.

Private key per il tuo server

Invia una key che inizia con sk_ nell'header X-API-Key. Accesso completo a ogni endpoint, inclusi sync, async e batch. Le key sono memorizzate come hash SHA-256, quindi il testo in chiaro viene mostrato una sola volta alla creazione e mai più.

X-API-Key: sk_...

Public key per il browser

Scambia una key che inizia con pk_ per un JWT a breve durata su POST /v1/auth/token, poi inviala come Authorization: Bearer. Le public key funzionano solo dai domini in whitelist, e POST /v1/auth/refresh rinnova il token prima della scadenza.

Authorization: Bearer <token>

Una private key usata da un browser viene rifiutata a priori. L'API legge l'header Origin e rifiuta le key sk_ provenienti da ambienti browser, così una server key trapelata non può essere rigiocata da una pagina.

Leggi la guida all'autenticazione
Endpoint

Quarantanove conversioni. Altri sei per il web stesso.

Gli endpoint per le pagine web richiedono un body JSON con gli URL. Gli endpoint per formati dati, documenti e immagini richiedono un upload multipart/form-data. Gli endpoint V2 richiedono JSON e condividono le stesse key e la stessa allowlist di domini, su contatori di quota propri.

  1. Pagine web

    5 endpoint

    Renderizza qualsiasi URL come PDF, screenshot o markdown pulito, e riunisci un intero sito in un solo documento. Batch e async sono entrambi supportati.

    POST /v1/convert/url-to-pdf
  2. Formati dati

    11 endpoint

    JSON da e verso XML, YAML, CSV e TOML, CSV da e verso XML, e markdown verso HTML. Dati strutturati in ingresso, dati strutturati in uscita.

    POST /v1/convert/json-to-xml
  3. Documenti in PDF

    11 endpoint

    HTML, markdown, Word, Excel, PowerPoint, la famiglia OpenDocument, Pages e Numbers, tutti renderizzati in PDF con la stessa forma di richiesta.

    POST /v1/convert/doc-to-pdf
  4. Conversioni immagini

    22 endpoint

    JPEG, PNG, WebP, HEIC e SVG in qualsiasi combinazione, più PDF verso JPEG e un compressore che tiene conto della qualità.

    POST /v1/convert/heic-to-webp
  5. Web intelligence

    6 endpoint

    perceive, discover, lookup, distill, ingest e watch. Renderizza una pagina, mappa un sito, risolvi un'entità, estrai campi strutturati, costruisci passaggi incorporabili, e vieni avvisato quando una pagina cambia.

    POST /v2/perceive

Gli errori tornano come JSON con un campo detail: 401 per una key mancante o non valida, 402 quando si raggiunge il limite mensile, 403 per un dominio o endpoint che la tua key non può usare, e 413 per un file oltre il limite di dimensione del tuo piano.

Sfoglia tutti gli endpoint
In pratica

Una richiesta e una risposta.

Ogni endpoint segue la stessa forma. Invia una key, ricevi un link di download prefirmato e i metadati che lo accompagnano.

curl -X POST https://api.enconvert.com/v1/convert/url-to-pdf \  -H "X-API-Key: sk_your_private_key" \  -H "Content-Type: application/json" \  -d '{"url": "https://example.com"}'{  "presigned_url": "https://econverter.nyc3.cdn.digitaloceanspaces.com/...",  "object_key": "live/files/12345/url-to-pdf/example_20250202_120530123.pdf",  "filename": "example_20250202_120530123.pdf",  "file_size": 45678,  "conversion_time_seconds": 3.21}
Costruito su questo

Una API, quattro porte.

REST è la fondazione. Ogni altra superficie è un modo più snello per raggiungere gli stessi endpoint con la stessa key.

SDK Node.js

Metodi tipizzati, download in streaming, recupero automatico da un job scaduto, e una vera gerarchia di errori invece di diramazioni sui codici di stato. Zero dipendenze a runtime, ESM e CJS.

Vedi su npm

Strumento a riga di comando

Tutta l'API come un solo comando da terminale, per shell, script e job CI dove un client HTTP è più cerimonia di quanto il compito meriti.

Vedi la CLI

Nodo n8n

Converti, estrai e scansiona dentro un workflow senza scrivere una richiesta o gestire tu stesso il polling di un job.

Vedi il nodo n8n

Server MCP

Gli stessi endpoint esposti come strumenti che il tuo agente può chiamare direttamente, per Claude, Cursor e Windsurf.

Vedi il server MCP

Domande sull'API

https://api.enconvert.com. Ogni endpoint v1 e v2 passa da questa unica base URL, quindi non c'è nulla di regionale o per-tenant da configurare.
Per le chiamate server-to-server, invia una private key che inizia con sk_ nell'header X-API-Key. Per le chiamate dal browser, scambia una public key che inizia con pk_ per un JWT a breve durata su POST /v1/auth/token e inviala come Authorization: Bearer. Le public key funzionano solo dai domini che metti in whitelist nella dashboard.
V1 sono i 49 endpoint di conversione: file e pagine web in ingresso, file convertiti in uscita. V2 sono sei endpoint di web intelligence (perceive, discover, lookup, distill, ingest e watch) che renderizzano, cercano, estraggono e monitorano pagine live. Usano le stesse key e la stessa allowlist di domini, e vengono misurati su contatori separati.
Entrambi, a seconda dell'endpoint. I cinque endpoint per le pagine web richiedono un body JSON contenente l'URL. Gli endpoint per formati dati, documenti e immagini richiedono un upload di file in multipart/form-data.
L'API risponde 402 con un campo detail che indica i conteggi usati e consentiti. Un batch che ti farebbe superare la quota residua viene rifiutato in anticipo invece di essere elaborato parzialmente, così non paghi mai per un'esecuzione a metà.
Sì, @enconvert/node-sdk per Node.js e TypeScript. Chiama gli stessi endpoint pubblici con zero dipendenze a runtime e distribuisce sia build ESM che CJS, così le chiamate SDK e le chiamate HTTP dirette si mescolano liberamente in un'unica codebase.

Inizia con una richiesta.

La quickstart ti guida nella tua prima conversione in tre passaggi, con esempi in cURL, Python e JavaScript.