Document Conversion Cloud API

Browse our Products

Are you looking for an evaluation version of a product?

If so you can download any of the below versions for testing. The product will function as normal except for an evaluation limitation. At the time of purchase we provide a license file via email that will allow the product to work in its full capacity. If you would also like an evaluation license to test without any restrictions for 30 days, please follow the directions provided here.

Are you having troubles in downloading?

If you experience errors, when you try to download a file, make sure your network policies (enforced by your company or ISP) allow downloading ZIP and/or MSI files.

Installation
The package is available at nuget.org and it can be installed via package manager console by executing following command:
PM> NuGet\Install-Package GroupDocs.Conversion-Cloud

Document Conversion .NET Cloud REST API

GroupDocs.Conversion Cloud SDK for .NET offers a robust solution for seamless document conversion across 50+ file formats, including PDF, DOCX, XLSX, and PPTX, without the need for any third-party tools. Developers can easily integrate this API into their C# and ASP.NET applications to convert entire documents or specific pages, auto-detect source formats, apply watermarks, replace missing fonts, and manage file encryption. Additional features include batch conversion, custom conversion logic, multi-format output, and the ability to track conversion progress. This versatile API also supports advanced customization options for managing fonts, spreadsheet sheet selection, and even Optical Character Recognition (OCR) for image-based text extraction. GroupDocs.Conversion Cloud SDK ensures smooth integration into your cloud-based .NET apps, offering efficient, high-quality document handling.

Document Conversion

Convert Documents - Convert documents across many formats like PDF, DOCX, XLSX, PPTX.
Convert Specific Pages - Convert selected pages or ranges of a document.
Auto-detect Document Format - Detect source format automatically, no file extension needed.
Load Documents with Options - Load docs with options: passwords, custom fonts, sheet selection.
Font Replacement - Replace missing fonts with alternatives during conversion.
Watermarking - Add custom text or image watermarks to any page.
Page-by-Page Conversion - Convert documents page by page or via custom ranges.
Resolution and Quality Control - Adjust output resolution and quality for images and text.
Password Protection - Add password protection to output files when supported.
Batch Conversion - Convert multiple documents in one batch operation.
Custom Conversion - Apply custom logic and parameters with advanced options.
Multi-format Output - Convert one document into multiple formats at once.
Conversion Tracking - Track conversion status in real time within your app.
Advanced Watermarking - Customize watermark position, size, color, transparency.
Language Translation - Combine conversion with translation for multilingual docs.
Document Merge - Merge multiple documents into one output file.

Document Information Extraction

Basic Document Information - Get basic info such as file type and page count.
CAD Information - Extract CAD layers and layout details.
Email Information - Extract folder structure and metadata from email files.
PDF Information - Get PDF details like printing restrictions and metadata.
Project Management Information - Get project data like start/end dates from files.
Text Content Extraction - Extract raw or formatted text from documents.
Image Extraction - Extract images embedded in documents.
Metadata Extraction - Retrieve metadata like author, title, dates.
Table of Contents Extraction - Extract the table of contents from documents.
Field Data Extraction - Extract form field data from PDFs or HTML.
OCR Support - Use OCR to extract text from images or scans.

API and SDK Features

Supported Formats Info - Get full list of supported conversion formats.
Document Conversion Endpoint - Use core endpoint for document conversion.
File Management Endpoints - Upload, download, copy, move, delete files in cloud.
Folder Management Endpoints - Create, copy, move, delete folders in cloud storage.
Storage Information Endpoints - Get cloud storage usage and file details.
SDK Availability - SDKs for .NET, Java, PHP, Node.js, Python, Ruby with examples.
API Explorer - Test API endpoints via built‑in Swagger UI.
Cross-Platform SDKs - Cross‑platform SDKs for .NET, Java, PHP, Python, Ruby, Node.js.
Custom Callbacks - Implement callbacks to monitor conversion status in real time.
Advanced API Customization - Configure API for large files, timeouts, retries.
Localization Support - Support multiple languages and regional settings.
API Rate Limiting - Manage API rate limits for balanced usage.

Load Options

CAD Files Load Options - Set CAD options: layout name, background color, drawing type.
Spreadsheet Files Load Options - Configure fonts, gridlines, ranges, skip empty rows/cols.
CSV Files Load Options - Set custom separators, encoding, auto formula conversion.
Diagram Files Load Options - Set default fonts for diagram conversion.
Email Files Load Options - Preserve email metadata, display options, folder structure.
OneNote Files Load Options - Handle fonts, sections, and password protection for OneNote.
PDF Files Load Options - Control password, annotations, form flattening, embedded files.
Presentation Files Load Options - Manage hidden slides, password protection, default fonts.
Text Files Load Options - Control numbering detection and formatting for texts.
Word Processing Files Load Options - Handle track changes, comments, and passwords in Word docs.
Web Files Load Options - Convert web docs with/without page numbers and embedded resources.
Vector Image Support - Convert SVG, WMF, EMF vector images while retaining scalability.
Multi-page TIFF Support - Convert selected pages of multi‑page TIFFs with custom order.
Encoding Detection - Automatically detect text encoding for accurate conversion.
HTML Load Options - Convert HTML with control over embedded resources and media.
PDF Digital Signatures - Manage PDF digital signatures for authenticity during conversion.

Storage API Features

Check Storage Existence - Verify cloud storage availability for file management.
Check File/Folder Existence - Ensure files/folders exist in cloud storage before processing.
Retrieve Storage Space Usage - Monitor storage quotas and usage to avoid limits.
Retrieve File Versions - List stored file versions for effective version control.
File Upload with Overwrite - Upload files with option to overwrite existing versions.
Versioning Control - Manage file versions, restore previous ones, track changes.
File Metadata Retrieval - Access file metadata like size, format, creation date.
Folder Synchronization - Sync local and cloud folders for up‑to‑date versions.
Storage Quota Management - Monitor and manage storage quotas with real‑time alerts.

Docker and Self-Hosting

Self-hosting in Docker - Deploy GroupDocs.Conversion via Docker with custom config and storage.
Google Cloud Storage Integration - Connect Google Cloud storage for streamlined file management.
AWS S3 Cloud Storage Integration - Integrate AWS S3 storage with credentials and region settings.
Auto-scaling - Implement auto‑scaling to handle fluctuating workloads.
Persistent Storage - Use persistent volumes for Docker containers to retain data.
Container Health Monitoring - Set up health checks and auto‑recovery for Docker containers.
Customized Docker Images - Build custom Docker images with dependencies and optimizations.

Licensing and Authentication

Evaluation Mode - Convert first two pages with watermarks during trial.
Secure Authentication - Use ClientId and ClientSecret for secure API access.
Custom Licensing Models - Implement per‑user or per‑usage licensing models.
Multi-tenant Authentication - Support multi‑tenant authentication for multiple organizations.
Token Expiry Management - Manage token expiration and refresh JWTs for long‑term access.
Trial and Subscription Management - Automate trial-to-paid transitions with feature unlocks.

Supported Document Formats

Text Formats: DOC, DOCX, TXT, RTF
Spreadsheet Formats: XLS, XLSX, XLSB, XLSM, CSV, ODS, XLS2003
Presentation Formats: PPT, PPTX, PPS, PPSX, ODP
Image Formats: BMP, GIF, JPEG, JPG, PNG, TIF, TIFF, ICO
Email Formats: MSG, EML, EMLX, MHT
Web Formats: HTM, HTML
PDF Format: PDF (includes password-protected PDFs)
Diagram Formats: VSD, VSDX, VSS, VST, VDW, VSX, VTX
Project Management Formats: MPP, MPT
Other Formats: DWG, DXF, PSD, SVG, XPS

Quick Start

Get your API credentials

To use GroupDocs.Conversion Cloud, you’ll need to sign up at GroupDocs.Cloud Dashboard and get your Client ID and Client Secret.

Initialize the API

Use the following code to start using the GroupDocs.Conversion Cloud SDK for .NET:

// Initialize the API instance
var configuration = new Configuration
{
    ClientId = "YourClientId",
    ClientSecret = "YourClientSecret"
};
var conversionApi = new ConversionApi(configuration);

Convert a document

Once initialized, use this basic example to convert a document:

// Set up conversion settings
var convertSettings = new ConvertSettings
{
    FilePath = "input.docx",
    Format = "pdf"
};

// Convert the document
var response = conversionApi.ConvertDocument(convertSettings);

// Save the converted file
File.WriteAllBytes("output.pdf", response.File);

With this quick start guide, you’re all set to begin converting documents using GroupDocs.Conversion Cloud in your .NET applications. For more details, visit the documentation.

Convert Documents Between Various Formats Cloud API

This code allows developers to convert documents between various formats programmatically, eliminating manual conversions. It supports over 50 file formats, making it ideal for application developers requiring multi-format support.

// Initialize the API instance
var conversionApi = new ConversionApi(new Configuration { ClientId = "YourClientId", ClientSecret = "YourClientSecret" });

// Set up the conversion settings: source format, target format, etc.
var convertSettings = new ConvertSettings
{
    // Specify input file path and desired output format
    FilePath = "input.docx",
    Format = "pdf"  // Convert DOCX to PDF
    
    // Optional: specify page range, font substitution, etc.
};

// Execute the conversion and retrieve the converted file
var response = conversionApi.ConvertDocument(convertSettings);

// Save the converted document to the specified location
File.WriteAllBytes("output.pdf", response.File);

Convert Specific Pages of a Document Cloud API

This example demonstrates how developers can convert only specific pages, saving processing time and reducing file sizes when only a part of the document is needed.

// Initialize the API instance with authentication credentials
var conversionApi = new ConversionApi(new Configuration { ClientId = "YourClientId", ClientSecret = "YourClientSecret" });

// Configure the settings to convert specific pages (e.g., pages 1 to 3)
var convertSettings = new ConvertSettings
{
    FilePath = "input.pptx",
    Format = "pdf",  // Convert PPTX to PDF
    
    // Specify the pages to convert (e.g., first 3 pages)
    Pages = new List<int> { 1, 2, 3 }
};

// Execute the conversion
var response = conversionApi.ConvertDocument(convertSettings);

// Save the resulting file
File.WriteAllBytes("output_pages1-3.pdf", response.File);

Auto-detect Document Formats for Conversion

This snippet highlights the ability to convert documents even when the file extension is unknown, making it highly useful for handling user-uploaded files where formats may not be clearly defined.

// Initialize the Conversion API with credentials
var conversionApi = new ConversionApi(new Configuration { ClientId = "YourClientId", ClientSecret = "YourClientSecret" });

// Configure settings for auto-detecting format without file extension
var convertSettings = new ConvertSettings
{
    FilePath = "input_file",  // No file extension required
    Format = "pdf"  // Desired output format (e.g., PDF)
};

// Execute the conversion
var response = conversionApi.ConvertDocument(convertSettings);

// Save the converted file to the output path
File.WriteAllBytes("output.pdf", response.File);