PDF to Multiple Formats Conversion API Documentation

PDF Parsing and Formatted Output API
Category: Image Recognition
Endpoint: POST https://api.gugudata.io/v1/imagerecognition/pdf2format?appkey={{appkey}}&type={{type}}
Description: Supports output in TEXT, HTML, XML, and TAG formats.
Overview
The PDF Parsing and Formatted Output API by GuGuData provides a convenient way to convert PDF documents into multiple output formats. Whether you need TEXT, HTML, XML, or TAG files, this API offers millisecond-level parsing performance for standard PDF files. Backed by machine learning, it continuously refines its recognition accuracy and handles files up to at least 1M with impressive speed.
Key highlights:
- Multiple format support – Convert PDF to TEXT, HTML, XML, or TAG.
- High accuracy – Machine learning-driven improvements over time.
- Fast performance – Millisecond-level handling for typical PDF file sizes.
- HTTPS/TLS – Compatible with TLS v1.0–v1.3, fully Apple ATS-ready.
- Nationwide multi-node CDN – Ensures rapid response and reliability.
Demo URL
https://api.gugudata.io/v1/imagerecognition/pdf2format/demo
Request Parameters
Send a POST request to the endpoint, including both appkey and type in the query string, and attach the PDF file in the form-data body.
| Parameter | Type | Required | Default Value | Description |
appkey | string | Yes | YOUR_APPKEY | Your APPKEY obtained from GuGuData's Developer Center (passed in query string). |
type | string | Yes | YOUR_VALUE | The output format: text, html, xml, or tag (passed in query string). |
pdffile | file | Yes | YOUR_VALUE | The PDF file you wish to parse, uploaded in form-data. |
Example:
POST https://api.gugudata.io/v1/imagerecognition/pdf2format?appkey={{appkey}}&type={{type}}
Then attach the PDF file in the request body as form-data with the field name pdffile.
Response Parameters
A successful request returns JSON with status info and parsed results. Key fields include:
| Parameter | Type | Required | Description |
DataStatus.statusCode | int | Yes | The API response status code. |
DataStatus.statusDescription | string | Yes | A short description of the response status. |
DataStatus.responseDateTime | string | Yes | The timestamp for when the data was returned. |
DataStatus.dataTotalCount | int | Yes | The total data count for this request, often used for pagination. |
Data.result | string | Yes | The parsed PDF data, in the format specified by the type parameter. |
Error Codes
The table below lists potential error codes and their implications:
| Error Code | Error Content | Notes |
100 | Normal response | Request successful. |
101 | Parameter error | Check for missing or invalid parameters (e.g., pdffile missing). |
102 | Request rate limited | Exceeded 100 requests per second limit. |
103 | Account overdue | Requires payment or account reactivation. |
104 | Invalid APPKEY | Verify the APPKEY from your Developer Center. |
110 | API response error | A general error indicating unexpected API behavior. |
Features
- General recognition API – Compatible with standard PDF files.
- Multiple format output – TEXT, HTML, XML, or TAG.
- Perfect formatting in HTML – Preserves layout for web-based usage.
- Machine learning – Improved recognition accuracy over time.
- Fast recognition – Processes 1M files in milliseconds.
- HTTPS (TLS 1.0–1.3) – Secure data transmission.
- Apple ATS compatibility – Ideal for iOS/macOS integrations.
- Multi-node CDN – Consistent performance across diverse regions.
- Load-balanced – Ensures swift responses even under heavy load.
Additional Notes for Developers
- File size: For large PDFs, consider splitting them or optimizing them beforehand.
- Formatting: The HTML output provides near-original layout, making it ideal for display or conversions.
- Mixed content: Some PDFs contain images or vector text. Depending on the content, an OCR approach may be needed if the PDF lacks embedded text.
Getting Started
- Sign up at GuGuData.io – Acquire your
appkey. - Construct a POST request – Include
appkeyandtypein the query parameters; attach the PDF aspdffilein form-data. - Parse the JSON response – Read
Data.resultfor the extracted data in your chosen format. - Integrate – Incorporate the parsed output into your data pipelines or applications.
About GuGuData
GuGuData offers enterprise-grade data solutions and powerful APIs for a global audience. From OCR services to SSL Certificate Parsing, our infrastructure handles large-scale requests with speed and precision.
Key Highlights:
- Nine years in business – Trusted by thousands of developers and organizations.
- 4.2k+ APIs – A growing library of data-driven functionalities.
- 95% customer satisfaction – Emphasis on reliability, performance, and user-centered design.
Use the PDF Parsing and Formatted Output API to streamline your PDF document workflows with immediate format-specific results. Visit our official site to discover more data solutions from GuGuData.