# Compress a PDF

Make a PDF file smaller by packing its contents tighter and, if you allow it, re-saving its pictures at a lower resolution.

- Endpoint: `POST https://setget.net/v1/tools/pdf-compress` with JSON `{"input": {...}}` (add `"wait": 30` to hold the reply until the job finishes)
- MCP: `run_tool` with `slug` = `pdf-compress`
- Page: https://setget.net/tools/pdf-compress

## Files in, files out

This is a file tool. Its file inputs take file references, not file contents and not web addresses.

- Get a reference by uploading: `curl -T FILE https://setget.net/drop/` prints a line `ref  <id>/f1`. Or `POST https://setget.net/v1/drops` with `{"files":[{"name","size"}]}`, PUT the bytes to the returned `upload.url` with the listed headers, and use the file's `ref`. Over MCP use the `drop` tool. A file under about 700 KB can also be sent in place as a `data:<type>;base64,<content>` URI.
- Uploads are at most 100 MB per file, are readable by anyone with the link, and expire (one hour by default). Programs are refused.
- The tool runs as a job. The reply is `{"tool", "ms", "result", "files", "job"}`: `result` is JSON, and every result file comes back in `files` as `{"name", "size", "content_type", "kind", "url", "ref"}`. Download it from `url`, or pass `ref` as the input of another file tool.
- A job still running when the wait ends answers 202 with `job`. Follow it with `GET https://setget.net/v1/jobs/<id>?wait=30`, or stream progress from `GET https://setget.net/v1/jobs/<id>/events` (over MCP: the `job` tool). A person can watch it at `job.url`.

## Inputs

- `file` (required, file, a file reference such as `DROP_ID/f1`, accepts pdf): The PDF to make smaller.
- `quality` (optional, string, one of `lossless`, `high`, `medium`, `low`, default `"medium"`): lossless changes nothing you can see. high keeps pictures at print quality (300 dpi). medium is right for screens and email (150 dpi). low gives the smallest file (96 dpi).
- `password` (optional, string): The password of the PDF, if it is locked. It is used once to open the file and is never stored or shown. The result is not locked.

## Example 1: Compress for screens and email

Upload first. Each placeholder below stands for the reference of one upload: `DROP_ID/f1` = [sample.pdf](https://setget.net/static/samples/sample.pdf).

```json
{"input":{"file":"DROP_ID/f1"},"wait":30}
```

## Example 2: Smaller without changing any picture

Upload first. Each placeholder below stands for the reference of one upload: `DROP_ID/f1` = [sample.pdf](https://setget.net/static/samples/sample.pdf).

```json
{"input":{"file":"DROP_ID/f1","quality":"lossless"},"wait":30}
```

**How much smaller will my PDF get?** It depends on what is inside. PDFs full of photos or scans often shrink by half or more at medium. PDFs that are mostly text are small already and may shrink only a few percent.

**What is changed at each quality?** lossless only packs the file tighter. high, medium and low also re-save photos inside the PDF at 300, 150 or 96 dots per inch with stronger JPEG compression. Text and line art always stay sharp, and so do pictures with only a few colours, such as logos and diagrams.

**The result is the same size as my file. Why?** When no setting makes the file smaller, you get your original back unchanged and the result says so. This happens with PDFs that are already compressed well.

**Is text still selectable afterwards?** Yes. Text, links, bookmarks and form fields are kept.

**Can I use a PDF that is locked with a password?** Yes. Give the password in the password input. It is used once to open the file, is not stored and is not shown anywhere. The result is not locked. Without the right password a locked PDF cannot be read.
