API Documentation

Integrate our PDF tools into your workflow.

Introduction

Welcome to the PDF Tools API documentation. Our API enables you to perform PDF conversion, manipulation, and management programmatically. Designed by developers, for developers.

Authentication

All API requests must be authenticated using a Bearer token in the header. You can obtain your API key by contacting our sales team.

Authorization: Bearer YOUR_API_KEY

API Endpoints

Convert File

POST/api/convert

Convert files to other formats. Supports PDF, images, documents, and more.

Parameters

Parameter	Type	Description
file *	file	The file to process (multipart/form-data). Supported formats: PDF, JPG, PNG, WEBP, HEIC, DOCX, XLSX, PPTX.
output_format *	string	The desired target format (e.g. 'docx', 'xlsx', 'pptx', 'jpg', 'png', 'webp', 'pdf')

Example request

curl -X POST https://filesbuddy.com/api/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.png" \
  -F "output_format=pdf"

Example response

{
  "success": true,
  "download_url": "https://filesbuddy.com/download/...",
  "file_name": "image.pdf"
}

Protect PDF

POST/api/protect-pdf

Encrypt and protect your PDF documents with a password.

Parameters

Parameter	Type	Description
file *	file	The file to process (multipart/form-data). Supported formats: PDF, JPG, PNG, WEBP, HEIC, DOCX, XLSX, PPTX.
password *	string	The password to set or use for unlocking

Example request

curl -X POST https://filesbuddy.com/api/protect-pdf \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf" \
  -F "password=secret"

Example response

{
  "success": true,
  "download_url": "https://filesbuddy.com/download/...",
  "file_name": "protected-document.pdf"
}

Unlock PDF

POST/api/unlock-pdf

Remove password protection from PDF documents (password required).

Parameters

Parameter	Type	Description
file *	file	The file to process (multipart/form-data). Supported formats: PDF, JPG, PNG, WEBP, HEIC, DOCX, XLSX, PPTX.
password *	string	The password to set or use for unlocking

Example request

curl -X POST https://filesbuddy.com/api/unlock-pdf \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/protected.pdf" \
  -F "password=secret"

Example response

{
  "success": true,
  "download_url": "https://filesbuddy.com/download/...",
  "file_name": "unlocked-document.pdf"
}

Split PDF

POST/api/split-pdf

Split a PDF into multiple files or extract specific pages.

Parameters

Parameter	Type	Description
file *	file	The file to process (multipart/form-data). Supported formats: PDF, JPG, PNG, WEBP, HEIC, DOCX, XLSX, PPTX.
pages *	string	Page range (e.g. '1,3,5-7')

Example request

curl -X POST https://filesbuddy.com/api/split-pdf \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf" \
  -F "pages=1,3-5"

Example response

{
  "success": true,
  "download_url": "https://filesbuddy.com/download/...",
  "file_name": "split-document.zip"
}