
Convert PPT to PDF
Convert PowerPoint slides into PDF documents.
Extract PDF text as HTML, text, Markdown, or JSON
Choose HTML, plain text, Markdown, or a JSON string.
Keep the original page order, with numbered sections in HTML, Markdown, and JSON.
Extract readable text already present in PDFs, including Chinese and English.
Submit a PDF file or a publicly accessible PDF URL.
Display extracted text as a readable UTF-8 HTML document.
Prepare PDF text for search, indexing, and content processing.

HTTP Protocol:HTTPS
HTTP Method:POST
HTTP Endpoint:https://api.gugudata.io/v1/imagerecognition/pdf2format
Response Type:application/json; charset=utf-8
DEMO Endpoint:https://api.gugudata.io/v1/imagerecognition/pdf2format/demo
Live Demo:Try Interactive Demo
Full API Docs:developers.gugudata.io
| Name | Type | Is Required | Default Value | Remark |
|---|---|---|---|---|
| appkey | string | true | YOUR_APPKEY | Your API key. Send it as a query parameter. |
| type | string | true | html | Output format: html, text (alias txt), markdown (alias md), or json. The result is always a string. |
| pdffile | file | false | PDF upload. Provide exactly one of pdffile, file, or file_url. Maximum 20 MiB and 100 pages. Encrypted, damaged, and textless PDFs are not supported. | |
| file | file | false | Compatible alias for pdffile. Do not combine it with another input. | |
| file_url | string | false | https://storage.gugudata.io/pdf/demo.pdf | Public HTTP or HTTPS PDF URL, as an alternative to a file upload. |
| Name | Type | Remark |
|---|---|---|
| dataStatus.requestParameter | string | Input source, selected format, file size, and page count. The Demo shows its public sample PDF URL. |
| dataStatus.statusCode | integer | Business status code: 200 for success. |
| dataStatus.statusDescription | string | Business status description. |
| dataStatus.responseDateTime | string | Response date and time. |
| dataStatus.dataTotalCount | integer | Number of conversion results returned. |
| data.result | string | Extracted HTML, plain text, Markdown, or serialized JSON containing ordered page text. Parse this string again when type=json. Does not include OCR, images, or complex layout reconstruction. |
| Status Code | Explanation of Status Code | Remarks |
|---|---|---|
| 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. |
| 413 | PDF exceeds the size or page limit. | Use a PDF of at most 20 MiB and 100 pages. |
| 422 | PDF cannot be converted. | Check that the PDF is readable, unencrypted, and contains text. Output must not exceed 20 MiB. |
| 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. |
| 502 | PDF retrieval or conversion response failed. | Check that the public PDF URL can be downloaded. |
| 503 | Conversion is temporarily unavailable. | Try again later. |
Connect your AI client once, authorize in the browser, and the client can use the GuGuData API tools available to your account. You do not need to paste an appkey into the MCP client.
https://mcp.gugudata.io/mcp{
"mcpServers": {
"gugudata": {
"url": "https://mcp.gugudata.io/mcp",
"transportType": "streamable-http"
}
}
}
Convert PowerPoint slides into PDF documents.

Convert PDF text into readable HTML

Summarize long PDF documents in your chosen language

Extract searchable text from scanned PDFs