Logo FileConvertFree
✨ Prova anche questi nuovi strumenti AI
• PDF to Word → | Image to Text →
FileConvertFree Developer Platform

Integra la conversione file nella tua app

Usa la REST API FileConvertFree in applicazioni, automazioni e sistemi aziendali.

API v1: La documentazione è pubblica; le chiamate API richiedono Premium o Pro attivo.
Open Dashboard View Plans Interactive API Docs
Base URL
REST API v1
https://fileconvertfree.com/api1
Authentication
X-API-Key header
X-API-Key: fcf_live_••••••••

Avvio rapido

Sign in to your FileConvertFree account.
Use an active Premium or Pro plan.
Open Dashboard → Developer API → Create API Key. Save the full key immediately because it is shown only once.
Send the key in the X-API-Key header with every protected API request.

Piani e limiti API

Limits are account-wide across all of your API keys. Creating more keys does not create more quota.

Premium

200 / day
  • 200 Daily requests
  • 30 Requests / minute
  • 200 MB Maximum file size
  • 3 Active keys max

Pro

400 / day
  • 400 Daily requests
  • 60 Requests / minute
  • 200 MB Maximum file size
  • 3 Active keys max

Gestione chiavi API

1. Create a key

Go to your Dashboard and use the Developer API section. You may keep up to 3 active API keys. Give each key a useful name such as Production, Office App or Staging.

2. Save it once

The complete secret is displayed only after creation or regeneration. FileConvertFree stores a secure hash, not the plaintext secret, so the full key cannot be displayed later.

3. Regenerate a key

Regeneration creates a new secret and immediately revokes the old key. Update your application with the new key before closing the one-time secret dialog.

4. Revoke a key

Revoke a key if it is no longer needed or may have been exposed. It stops authenticating immediately. A revoked key record is automatically deleted after 7 days.

Sicurezza della chiave

Never share an API key, publish it in GitHub, put it in browser-side JavaScript, send it in screenshots, or store it in public code. Keep it in server environment variables or a secrets manager. If a key may be compromised, regenerate or revoke it immediately.

Endpoint disponibili

MethodEndpointPurpose / options
GET/v1/account/usageRead authenticated plan, key status, daily usage, remaining quota and rate-limit usage.
GET/healthPublic health check for API status and version.
POST/v1/pdf/to-wordConvert a valid PDF file to Word.
POST/v1/pdf/to-excelConvert a valid PDF file to Excel.
POST/v1/image/to-textExtract OCR text from an image. Optional multipart field: fast=true|false.
POST/v1/image/to-wordConvert an image to Word. Optional multipart field: fast=true|false.
POST/v1/image/to-excelConvert an image to Excel. Optional multipart field: fast=true|false.
POST/v1/image/remove-backgroundRemove an image background. Optional fields: format (default png), transparent=true|false, fast_mode=true|false.

Esempi di codice

import os import requests API_KEY = os.environ["FCF_API_KEY"] url = "https://fileconvertfree.com/api1/v1/pdf/to-word" with open("sample.pdf", "rb") as source: response = requests.post( url, headers={"X-API-Key": API_KEY}, files={"file": ("sample.pdf", source, "application/pdf")}, timeout=700, ) response.raise_for_status() with open("converted.docx", "wb") as out: out.write(response.content)
import { readFile, writeFile } from "node:fs/promises"; const key = process.env.FCF_API_KEY; const bytes = await readFile("scan.png"); const form = new FormData(); form.append("file", new Blob([bytes], { type: "image/png" }), "scan.png"); form.append("fast", "false"); const response = await fetch( "https://fileconvertfree.com/api1/v1/image/to-text", { method: "POST", headers: { "X-API-Key": key }, body: form } ); if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`); console.log(await response.json());
Use the JavaScript example on a server/Node.js environment. Do not expose your secret key in frontend/browser JavaScript.
curl -X POST "https://fileconvertfree.com/api1/v1/pdf/to-excel" \ -H "X-API-Key: $FCF_API_KEY" \ -F "file=@sample.pdf" \ --output converted.xlsx
<?php $apiKey = getenv('FCF_API_KEY'); $ch = curl_init('https://fileconvertfree.com/api1/v1/image/to-word'); $file = new CURLFile(__DIR__ . '/scan.png', 'image/png', 'scan.png'); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['X-API-Key: ' . $apiKey], CURLOPT_POSTFIELDS => ['file' => $file, 'fast' => 'false'], CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 700, ]); $body = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); if ($body === false || $status >= 400) { throw new RuntimeException('API request failed: HTTP ' . $status); } file_put_contents(__DIR__ . '/converted.docx', $body); curl_close($ch);

File supportati e convalida

PDF endpoints accept real PDF files. Image endpoints accept JPEG/JPG/JFIF, PNG, WebP, GIF, BMP and TIFF/TIF. The API checks both the filename extension and the real file signature, so simply renaming an unsupported file does not bypass validation.

Risposte API

File-conversion endpoints return the converted file body directly to your client. Image-to-text returns JSON. Internal converter download URLs are not exposed to API customers.

Errori HTTP

StatusMeaningTypical reason / action
401Missing, invalid, expired or revoked API key.Check X-API-Key. If the key was revoked/regenerated, replace it with the current secret.
403API access is not enabled.Your account does not currently have an active Premium or Pro entitlement.
409Key action conflicts with its current state.Examples: trying to create more than 3 active keys or regenerate a key that is not active.
413Uploaded file is too large.Use a file within your API plan limit (currently 200 MB).
415Unsupported or mismatched media type.Use a supported PDF/image and keep the correct extension; the API also validates file signatures.
422Invalid request content.The upload may be empty or required multipart data may be missing/invalid.
429Too many requests.You reached the per-minute rate limit or the account-wide daily quota. Retry later or wait for the daily reset.
5xxTemporary API or conversion-service failure.Retry with backoff. Infrastructure/backend failures are not charged against daily quota.

Come viene conteggiata la quota

Daily quota and per-minute rate limits are shared across every key on the same API account. Invalid or unsupported uploads rejected before conversion do not consume daily quota. Server/infrastructure failures are refunded from daily quota. Requests accepted for conversion may count even if the downstream converter later returns a client-side 4xx error. Daily quota resets according to the API server/database calendar day.

Usage check: GET https://fileconvertfree.com/api1/v1/account/usage

Domande frequenti

Can a Free account call the API?

No. The documentation is visible to everyone, but API access currently requires an active Premium or Pro website plan.

Does creating 3 keys triple my quota?

No. Keys share the same account-wide daily and per-minute limits.

Can I recover a lost secret?

No. The plaintext key is not stored. Regenerate the key and save the new secret.

What happens when my paid plan expires?

API access is disabled when the website account no longer has an active eligible plan. Renew Premium or Pro to restore eligible API access.

Integra FileConvertFree

Create your key from the dashboard, test it with the usage endpoint, then connect the conversion route your application needs.

Open DashboardInteractive API Docs