Name: PDF API: Merge, Split, Compress and Watermark PDFs
Brand: adrarsoft
SKU: api-adrarsoft-pdf-manipulator-api
Availability: InStock
Author: API Market

Shogun OfBG

# PDF Manipulator API

## Overview

The PDF Manipulator API edits PDF files in simple multipart calls. It merges several PDFs into one, splits a PDF by page ranges, reorders pages, compresses files with four quality levels, adds text or image watermarks with opacity, rotation, colour and tiling, and extracts text, tables and images as JSON, CSV or a ZIP. Each call takes the file and a small JSON `request` field with the options.

It is built for developers of document management, e-signature, invoicing, publishing and back office automation tools who need PDF operations without running a PDF library. In our tests two PDFs merged in one call, a three page file split into a ZIP and reordered, a text-only `CONFIDENTIAL` watermark tiled across every page, and text extraction returned the pages as JSON in about one second.

## Features

*   **6 operations**: merge, split, reorder, compress, watermark and extract.
*   **Text and image watermarks**: opacity, position, rotation, font size, colour and tiling.
*   **Compression levels**: `screen`, `ebook`, `printer` and `prepress`.
*   **Extraction**: text, tables and images as JSON, CSV or ZIP.
*   **Output choice**: single PDF or ZIP for multi-file results.
*   **Rate limit**: 10 requests per second on every plan.

## Use Cases

*   **Document management**: merge and split scanned files.
*   **Invoicing**: stamp invoices as PAID or DRAFT.
*   **Publishing**: reorder and compress files before distribution.
*   **Data entry**: extract text and tables from PDFs into your system.
*   **Compliance**: watermark confidential documents.

## API Documentation

### Base URL

All requests use the following base URL.

```
https://prod.api.market/api/v1/adrarsoft/pdf-manipulator-api
```

### Authentication

All requests are authenticated with the `x-api-market-key` header.

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Merge PDFs

Merges two or more PDFs in the order they are sent.

**Method:** `POST`

**Endpoint:** `/api/merge`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `files` | body | Two or more PDF files, repeat the form field per file | file | Yes | - | - |
| `request` | body | For example `{"output_format": "pdf"}` | string | Yes | - | - |
| `output_format` | query | `pdf` or `zip` | string | Yes | `zip` | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/adrarsoft/pdf-manipulator-api/api/merge?output_format=pdf' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -F 'files=@first.pdf' \
  -F 'files=@second.pdf' \
  -F 'request={"output_format":"pdf"}'
```

**Example Response (200 OK):**

The body is the merged PDF (`application/pdf`).

#### 2. Split a PDF

Splits a PDF into one file per page range.

**Method:** `POST`

**Endpoint:** `/api/split`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `file` | body | PDF file (multipart form field) | file | Yes | - | - |
| `request` | body | JSON string with the options for the operation | string | Yes | - | - |
| `output_format` | query | `pdf` or `zip` | string | Yes | `zip` | - |
| `ranges` | query | Page ranges, for example `1,2-3` | string | No | - | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/adrarsoft/pdf-manipulator-api/api/split?output_format=zip&ranges=1%2C2-3' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -F 'file=@document.pdf' \
  -F 'request={"output_format":"zip","ranges":"1,2-3"}'
```

**Example Response (200 OK):**

The body is a ZIP (`application/zip`) with one PDF per range.

#### 3. Reorder pages

Rearranges the pages in the order you give, using 1-based page numbers.

**Method:** `POST`

**Endpoint:** `/api/reorder`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `file` | body | PDF file (multipart form field) | file | Yes | - | - |
| `request` | body | JSON string with the options for the operation | string | Yes | - | - |
| `output_format` | query | `pdf` or `zip` | string | Yes | `zip` | - |
| `order` | body | New page order inside `request`, for example `[3, 1, 2]` | array of integers | Yes | - | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/adrarsoft/pdf-manipulator-api/api/reorder?output_format=pdf' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -F 'file=@document.pdf' \
  -F 'request={"output_format":"pdf","order":[3,1,2]}'
```

**Example Response (200 OK):**

The body is the reordered PDF (`application/pdf`).

#### 4. Compress a PDF

Reduces file size. Available on the Pro, Ultra and Mega plans.

**Method:** `POST`

**Endpoint:** `/api/compress`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `file` | body | PDF file (multipart form field) | file | Yes | - | - |
| `request` | body | JSON string with the options for the operation | string | Yes | - | - |
| `output_format` | query | `pdf` or `zip` | string | Yes | `zip` | - |
| `compress_level` | query | `screen`, `ebook`, `printer` or `prepress` | string | No | `ebook` | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/adrarsoft/pdf-manipulator-api/api/compress?output_format=pdf&compress_level=ebook' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -F 'file=@document.pdf' \
  -F 'request={"output_format":"pdf","compress_level":"ebook"}'
```

**Example Response (200 OK):**

The body is the compressed PDF (`application/pdf`).

#### 5. Add a watermark

Adds a text or image watermark to every page.

**Method:** `POST`

**Endpoint:** `/api/watermark`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `file` | body | PDF file (multipart form field) | file | Yes | - | - |
| `request` | body | JSON string with the options for the operation | string | Yes | - | - |
| `output_format` | query | `pdf` or `zip` | string | Yes | `zip` | - |
| `watermark` | body | Inside `request`: `text`, `image_url`, `opacity`, `x`, `y`, `rotation`, `font_size`, `color` as `[r, g, b]`, `repeat`, `repeat_spacing_x`, `repeat_spacing_y`, `image_width`, `image_height` | object | Yes | - | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/adrarsoft/pdf-manipulator-api/api/watermark?output_format=pdf' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -F 'file=@document.pdf' \
  -F 'request={"output_format":"pdf","watermark":{"text":"CONFIDENTIAL","opacity":0.3,"rotation":25,"font_size":36,"color":[200,0,0],"repeat":true}}'
```

**Example Response (200 OK):**

The body is the watermarked PDF (`application/pdf`). This call tiled a red `CONFIDENTIAL` across every page of a three page file.

#### 6. Extract content

Extracts text and tables, images, or both.

**Method:** `POST`

**Endpoint:** `/api/extract`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `file` | body | PDF file | file | Yes | - | - |
| `request` | body | For example `{"extract": "data", "output_format": "json"}` | string | Yes | - | - |
| `output_format` | query | `json`, `csv` or `zip` | string | Yes | `zip` | - |
| `extract` | query | `data`, `images` or `all` | string | No | `data` | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/adrarsoft/pdf-manipulator-api/api/extract?output_format=json&extract=data' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -F 'file=@document.pdf' \
  -F 'request={"extract":"data","output_format":"json"}'
```

**Example Response (200 OK):**

```json
{
  "metadata": {
    "total_pages": 3,
    "extracted_pages": 3,
    "timestamp": "2026-11-11T20:40:31.794773"
  },
  "content": {
    "title": "PAGE 1 of 3",
    "sections": [
      {
        "heading": "PAGE 1 of 3",
        "paragraphs": [
          "Account number 4417 1234 5678 9113"
        ],
        "tables": []
      },
      {
        "heading": "PAGE 2 of 3",
        "paragraphs": [
          "Account number 4417 1234 5678 9113"
        ],
        "tables": []
      }
    ]
  }
}
```

The `sections` list above is shortened to two of three pages.

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the JSON result is in the response body. |
| 400 | Bad Request | The file or `request` field is missing or the options are invalid. |
| 401 | Unauthorized | The `x-api-market-key` header is missing or the key is not valid. |
| 403 | Forbidden | Your key does not have an active subscription that includes this endpoint. |
| 404 | Not Found | The path does not match an endpoint of this API. Check the Base URL and path. |
| 422 | Unprocessable Entity | A required parameter such as `output_format` is missing. |
| 429 | Too Many Requests | You went over 10 requests per second or used up the quota of your plan. |
| 500 | Internal Server Error | The PDF could not be processed. Check that the file is a valid, unencrypted PDF. |
| 503 | Service Unavailable | The service is temporarily unavailable. Retry after a short wait. |

## Rate Limits

Every plan allows up to 10 requests per second, and each subscription plan has its own monthly quota. When you go over a limit, the API returns `429 Too Many Requests`. Throttle your requests, back off before retrying, and honour the `Retry-After` header when it is present.

## FAQ

*   **Why are there both a request field and query parameters?**
    The server reads the options from the `request` JSON field. Keep `output_format` in both so they match.

*   **Which plans include compression?**
    Pro, Ultra and Mega. The Free plan covers merge, split, reorder, watermark and extract.

*   **Can I use only a text watermark?**
    Yes. Send `text` without `image_url`.

*   **How do I send several files to merge?**
    Repeat the `files` form field once per file, in the order you want them merged.

## Contact Us

If you have any questions or need support, reach out through the chat embedded on this page or email us at hello@magicapi.com.


Merge, split, reorder, compress and watermark PDFs, and extract text and images as JSON or CSV, in simple multipart calls.

PDF API: Merge, Split, Compress and Watermark PDFs

FREE