Skip to main content

Command Palette

Search for a command to run...

PDF Splitter API Documentation

Published
4 min readView as Markdown
PDF Splitter API Documentation

PDF Splitting API

Category: Image Recognition
Endpoint: POST https://api.gugudata.io/v1/imagerecognition/pdf-splitter?appkey={{appkey}}&page_size={{page_size}}&is_zip={{is_zip}}
Description: Split PDF files into smaller documents by specified page size with optional ZIP compression.

Overview

The PDF Splitting API by GuGuData is designed to split large PDF files into smaller documents based on a defined page size. For multiple output files, the service can optionally compress them into a single ZIP archive, simplifying downloads and storage. Built on a fast, cloud-based infrastructure, this API securely processes your PDFs and delivers results via a nationwide CDN for minimal latency.

Key highlights:

  • Page-based splitting – Define page_size to create multiple smaller PDFs.
  • Optional ZIP output – Bundle all split files into a single compressed archive.
  • Secure & scalable – HTTPS connections and cloud-based architecture for fast processing.
  • RESTful interface – JSON-based responses for easy integration and automation.

Demo URL

https://api.gugudata.io/v1/imagerecognition/pdf-splitter/demo

Request Parameters

Submit a POST request to the endpoint, ensuring you set the appkey, page_size, and is_zip query parameters. Attach the PDF file in form-data:

ParameterTypeRequiredDefault ValueDescription
appkeystringYesYOUR_APPKEYYour APPKEY from GuGuData's Developer Center.
page_sizeintegerYesN/ANumber of pages per split PDF file (e.g., 5).
is_zipbooleanYesfalseWhether to compress the output into a single ZIP file (true/false).
filefileYesYOUR_VALUEThe PDF file to be split, included in form-data.

Example:

POST https://api.gugudata.io/v1/imagerecognition/pdf-splitter?appkey={{appkey}}&page_size={{page_size}}&is_zip={{is_zip}}

Upload the PDF under the field name file.

Response Parameters

Upon success, the API returns a JSON object with metadata and download URLs. Key fields include:

ParameterTypeRequiredDescription
dataStatus.statusCodeintegerYesAPI response status code (e.g., 200).
dataStatus.statusstringYesOverall operation status (e.g., SUCCESS).
dataStatus.statusDescriptionstringYesAdditional details about the request's outcome.
dataStatus.responseDateTimestringYesTimestamp for when the data was returned.
dataStatus.dataTotalCountintegerYesTotal count of data records (commonly 1).
data.uuidstringYesUnique identifier for the split operation.
data.num_filesintegerYesNumber of split PDF files produced.
data.pdf_filesarrayYesAn array of download URLs for the split files or the resulting ZIP archive.

Error Codes

Below are some common error codes:

Error CodeError ContentNotes
200SuccessThe operation completed successfully.
400Parameter errorMissing or invalid page_size, appkey, or file parameters.
401Invalid APPKEYEnsure your APPKEY is valid and active.
429Rate limit exceededToo many requests in a specific time frame.
500Server errorAn internal issue occurred; try again or contact support.

Features

  1. Split PDF files based on the specified page range.
  2. Optional ZIP compression for downloading multiple files at once.
  3. Fast cloud-based processing – Efficiently handle large documents.
  4. Secure file handling – Transfer data via HTTPS.
  5. Distributed CDN – Fast delivery of output files.
  6. Support for large PDFs – Capable of splitting extensive multi-page files.
  7. Automatic file cleanup – Temporary data is removed after processing.
  8. RESTful API with JSON – Simplifies integration with third-party apps or workflows.

Additional Notes for Developers

  • File size considerations: Splitting very large PDFs may take slightly longer; ensure client-side timeouts are suitable.
  • Zip usage: If is_zip is set to true, you'll receive a single ZIP archive link containing all the split PDF files.
  • Concurrency: Multiple simultaneous requests are supported, but watch out for rate limits.

Getting Started

  1. Sign up at GuGuData.io – Obtain your unique APPKEY.
  2. Construct a POST request – Include query parameters (appkey, page_size, is_zip) and attach the PDF as file.
  3. Parse the JSON response – Access the pdf_files array or ZIP link to download the results.
  4. Integrate – Incorporate the split PDFs into your workflows, archiving, or document processing pipelines.

About GuGuData

GuGuData excels in providing reliable data and file processing APIs for modern businesses and developers. Beyond PDF manipulation, our suite includes OCR services, HTML to PDF conversions, and more—each designed for scalability and ease of use.

Key Highlights:

  • Nine years in business – Long-standing track record of dependable data solutions.
  • 4.2k+ APIs – Continually growing catalog of features for data-intensive projects.
  • 95% customer satisfaction – Top-rated for speed, reliability, and support.

Leverage the PDF Splitting API to efficiently break down multi-page PDFs, simplifying file distribution, storage, or individual page processing. Explore more of GuGuData's offerings at our official site.

More from this blog

网页转 JSON API 怎么接:从 Prompt 到可校验的结构化数据

把网页内容变成 JSON,真正困难的部分通常不是“得到一段看起来像 JSON 的文本”,而是让字段含义、数据类型、缺失值、来源和更新规则都能被程序稳定处理。 语义化获取站点 JSON 结构内容 API 可以根据网页 URL 和自然语言 Prompt 提取自定义结构。它适合商品列表、文章索引、表格内容、站点研究和自动化数据准备等场景,但接口返回成功并不代表所有字段都已经过事实验证。生产接入仍需要本地

Aug 27, 20265 min read

地址逆编码接口 API

此文章对开放数据接口 API 之「地址逆编码接口 API」进行了功能介绍、使用场景介绍以及调用方法的说明,供用户在使用数据接口时参考之用,并且在目前更新的微信小程序实战开发项目中的使用场景。 1. 产品功能 此次开放了精准的地址坐标逆编码在线接口,用于对提供的 GPS 坐标转换为文字地址信息。 提供精准、高效的地理坐标逆编码接口; 返回的地址包含详细的位置信息; 一次可返回坐标周边的 10

Aug 3, 20261 min read

中英文排版规范化 API

此文章对开放数据接口 API 之「中英文排版规范化 API」进行了功能介绍、使用场景介绍以及调用方法的说明,供用户在使用数据接口时参考之用。 1. 产品功能 此次开放了中英文排版规范化在线接口,用于自动中英文排版、标点符号格式化,中英混排格式化 / 标点修正。 支持中英文混排格式化; 自动在汉字与英文字符、英文标点、数字间添加空格; 中文标点符号自动规范化,遵从 [标点符号用法 GB/T

Aug 3, 20261 min read

为阿里云站点部署免费 HTTPS

本文记录了部署在阿里云的站点,在申请了免费的 SSL 证书后如何正确的部署到站点上,让站点支持 HTTPS 访问。 阿里云引入了沃通作为 CA 证书供应商,并开放了免费 SSL 申请的页面,之前一直想给 咕咕监控 部署上全站 HTTPS,所以就申请了一个,但是部署的过程中遇到了些问题,所以记录下来备忘。 1. 证书申请 在阿里云后台的 CA 管理页面,填写相关的信息后就可以申请到一张免费的 CA

Aug 3, 20261 min read

GuGuData

178 posts