Cette page est aussi disponible en English
API REST officielle

Une API HTTP. Toutes les conversions, une seule URL de base.

Quarante-neuf endpoints de conversion pour les pages web, les formats de données, les documents et les images, plus six endpoints d’intelligence web qui rendent, recherchent, extraient et surveillent des pages en direct. Tout part de api.enconvert.com, et chaque conversion répond avec un lien de téléchargement présigné.

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

Deux types de clés, à un en-tête près.

Choisissez la clé adaptée à l’origine de la requête. Les deux se créent et se révoquent depuis le tableau de bord.

Clés privées pour votre serveur

Envoyez une clé commençant par sk_ dans l’en-tête X-API-Key. Accès complet à tous les endpoints, y compris synchrone, asynchrone et par lot. Les clés sont stockées sous forme de hachages SHA-256 : le texte en clair n’est affiché qu’une fois, à la création, jamais après.

X-API-Key: sk_...

Clés publiques pour le navigateur

Échangez une clé commençant par pk_ contre un JWT de courte durée via POST /v1/auth/token, puis envoyez-le en Authorization: Bearer. Les clés publiques ne fonctionnent que depuis les domaines que vous avez autorisés, et POST /v1/auth/refresh renouvelle le token avant son expiration.

Authorization: Bearer <token>

Une clé privée utilisée depuis un navigateur est rejetée sans appel. L’API lit l’en-tête Origin et refuse les clés sk_ provenant d’environnements navigateur, si bien qu’une clé serveur divulguée ne peut pas être rejouée depuis une page.

Lire le guide d’authentification
Endpoints

Quarante-neuf conversions. Six de plus pour le web lui-même.

Les endpoints de pages web prennent un corps JSON contenant des URL. Les endpoints de formats de données, de documents et d’images prennent un envoi multipart/form-data. Les endpoints V2 prennent du JSON et partagent les mêmes clés et la même liste blanche de domaines, sur leurs propres compteurs de quota.

  1. Pages web

    5 endpoints

    Rendez n’importe quelle URL en PDF, en capture d’écran ou en markdown propre, et regroupez un site entier en un seul document. Le traitement par lot et asynchrone sont tous deux pris en charge.

    POST /v1/convert/url-to-pdf
  2. Formats de données

    11 endpoints

    JSON vers et depuis XML, YAML, CSV et TOML, CSV vers et depuis XML, et markdown vers HTML. Des données structurées en entrée, des données structurées en sortie.

    POST /v1/convert/json-to-xml
  3. Documents vers PDF

    11 endpoints

    HTML, markdown, Word, Excel, PowerPoint, la famille OpenDocument, Pages et Numbers, tous rendus en PDF avec la même forme de requête.

    POST /v1/convert/doc-to-pdf
  4. Conversions d’images

    22 endpoints

    JPEG, PNG, WebP, HEIC et SVG dans n’importe quelle combinaison, plus PDF vers JPEG et un compresseur sensible à la qualité.

    POST /v1/convert/heic-to-webp
  5. Intelligence web

    6 endpoints

    perceive, discover, lookup, distill, ingest et watch. Rendez une page, cartographiez un site, résolvez une entité, extrayez des champs structurés, construisez des passages intégrables, et soyez averti quand une page change.

    POST /v2/perceive

Les erreurs reviennent en JSON avec un champ detail : 401 pour une clé manquante ou invalide, 402 quand la limite mensuelle est atteinte, 403 pour un domaine ou un endpoint que votre clé ne peut pas utiliser, et 413 pour un fichier au-dessus de la limite de taille de votre plan.

Parcourir tous les endpoints
En pratique

Une requête et une réponse.

Chaque endpoint suit la même forme. Envoyez une clé, recevez un lien de téléchargement présigné et les métadonnées qui l’accompagnent.

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}
Construit là-dessus

Une API, quatre portes d’entrée.

REST est le socle. Chaque autre surface est un moyen plus léger d’atteindre les mêmes endpoints avec la même clé.

SDK Node.js

Méthodes typées, téléchargements en streaming, récupération automatique après l’expiration d’un job, et une vraie hiérarchie d’erreurs au lieu de brancher sur des codes de statut. Zéro dépendance au runtime, ESM et CJS.

Voir sur npm

Outil en ligne de commande

Toute l’API en une commande de terminal, pour les shells, les scripts et les jobs CI où un client HTTP demande plus de cérémonie que la tâche ne le mérite.

Voir la CLI

Nœud n8n

Convertissez, scrapez et crawlez dans un workflow sans écrire de requête ni gérer vous-même le polling d’un job.

Voir le nœud n8n

Serveur MCP

Les mêmes endpoints exposés comme des outils que votre agent peut appeler directement, pour Claude, Cursor et Windsurf.

Voir le serveur MCP

Questions sur l’API

https://api.enconvert.com. Chaque endpoint v1 et v2 part de cette unique URL de base, il n’y a donc rien de régional ni de spécifique à un tenant à configurer.
Pour les appels serveur à serveur, envoyez une clé privée commençant par sk_ dans l’en-tête X-API-Key. Pour les appels depuis le navigateur, échangez une clé publique commençant par pk_ contre un JWT de courte durée via POST /v1/auth/token et envoyez-le en Authorization: Bearer. Les clés publiques ne fonctionnent que depuis les domaines que vous avez autorisés dans le tableau de bord.
V1 regroupe les 49 endpoints de conversion : fichiers et pages web en entrée, fichiers convertis en sortie. V2 regroupe six endpoints d’intelligence web (perceive, discover, lookup, distill, ingest et watch) qui rendent, recherchent, extraient et surveillent des pages en direct. Ils utilisent les mêmes clés et la même liste blanche de domaines, et sont mesurés sur des compteurs séparés.
Les deux, selon l’endpoint. Les cinq endpoints de pages web prennent un corps JSON contenant l’URL. Les endpoints de formats de données, de documents et d’images prennent un envoi de fichier en multipart/form-data.
L’API répond 402 avec un champ detail indiquant les quantités utilisées et autorisées. Un lot qui vous ferait dépasser l’allocation restante est rejeté d’emblée plutôt que traité partiellement, si bien que vous n’êtes jamais facturé pour une exécution à moitié terminée.
Oui, @enconvert/node-sdk pour Node.js et TypeScript. Il appelle les mêmes endpoints publics avec zéro dépendance au runtime, et livre à la fois des builds ESM et CJS, si bien que les appels SDK et les appels HTTP bruts se mélangent librement dans une même base de code.

Commencez par une seule requête.

Le guide de démarrage rapide vous accompagne dans votre première conversion en trois étapes, avec des exemples cURL, Python et JavaScript.