Word to HTML

Convert Word to HTML
Convert an uploaded Microsoft Word document into HTML.

Method: POST
Path: /v1/imagerecognition/word-to-html
Demo: https://api.gugudata.io/v1/imagerecognition/word-to-html/demo
OpenAPI: https://gugudata.io/assets/openapi/gugudata.openapi.3.1.json

Request Parameters:

appkey (string, required): Application key used for request authentication. Supply the value as a query parameter, form field, or multipart field according to the request content type.

file (file, required): Local file uploaded as multipart form data.

Response Fields:

html_url (string, required): CDN URL of the converted HTML file

html_content (string, optional): HTML content of the converted document (embedded content)

HTTP Status Codes:

200: Request processed successfully. Some endpoints expose a separate application-level status field in the response body, such as dataStatus.statusCode.

400: Invalid request parameters or request format. Check required fields, data types, and request body format.

401: Missing or unknown application key. Provide a valid appkey with the request.

403: The application key is recognized but access is not allowed. The key may be expired, inactive, or not permitted for the requested API.

429: Request rate or trial usage limit exceeded. Reduce concurrency or retry after the limit window resets.

500: Internal service error. Retry later or contact support if the error persists.

503: Upstream service unavailable. Retry later; the requested upstream dependency is temporarily unavailable.

Business Status Codes:

200 Normal return: Word document successfully converted and HTML URL returned

400 Parameter error: Invalid or missing required parameters, or unsupported file format (must be .doc or .docx)

429 Request frequency limited: Cannot exceed 100 requests per second

403 Account in arrears: Payment required to continue using the service

402 APPKEY error: Please check whether the APPKEY passed is obtained from the developer center

500 API response error: Internal server error during Word to HTML conversion

503 Service unavailable: External service temporarily unavailable

Key Features:

Support converting Word documents (.doc and .docx) to HTML format.

Preserve original document formatting, layout, and embedded content.

High accuracy and fidelity in document conversion.

Embedded images and media preserved in HTML output.

Automatic upload to Cloudflare R2 CDN for fast global delivery.

Support for complex Word documents with tables, images, and formatting.

Clean, semantic HTML output for easy integration.

Full API support for HTTPS (TLS v1.0 / v1.1 / v1.2 / v1.3).

Fully compatible with Apple ATS.

Nationwide multi-node CDN deployment.

Ultra-fast response, API interface load balancing built with multiple servers.

Details:
https://gugudata.io/details/word2html

{ "html_url": "string", "html_content": "string", "DataStatus": { "StatusCode": 100, "StatusDescription": "OK", "ResponseDateTime": "2026-01-01 00:00:00", "DataTotalCount": 1 } }

Request

Request Code Samples

Responses