Compress PDF API
Reduce PDF file size with presets or an exact target size — control image DPI and quality, downsample, subset fonts and strip metadata.
Environment
| Environment | Base URL |
|---|---|
| Production | https://api.sadafiles.com/v1 |
There is one environment and no sandbox, so every request here is real and counts toward your limits.
Request
POSThttps://api.sadafiles.com/v1/tools/compress-pdf
- Content type
- multipart/form-data
- Auth
- X-API-Key with tools:run
- Accepts
- Files per request
- 1 to 500
- Largest file
- 2 GB
- Job timeout
- 120 s
- Rate weight
- 2 units
- Web tool
- Use Compress PDF without code
Parameters
Send these as a JSON string in the options form field. Anything else is rejected.
| Name | Type | Default | Allowed |
|---|---|---|---|
mode | string | preset | preset, targetSize |
preset | string | recommended | low, recommended, extreme |
targetKb | integer | — | min 20, KB |
imageDpi | integer | 150 | min 36, max 600, dpi |
imageQuality | integer | 75 | min 10, max 100 |
stripMetadata | boolean | true | — |
subsetFonts | boolean | true | — |
grayscale | boolean | false | — |
Response
| Status | Body | When |
|---|---|---|
201 | The run finished within 60 seconds | |
202 | Job summary JSON | Still running; poll the job |
4xx, 5xx | Error JSON | See error codes |
A file response carries X-Sada-Job and X-Sada-Expires-At. For long work, post to /v1/tools/compress-pdf/jobs instead. See jobs and webhooks.
Also runs on the device
In the web tool and apps, Compress PDF can run locally with no upload. The API always processes on the server.
Ready settings
These settings power the matching pages on the site, and work the same in the API.
| Use | options |
|---|---|
| Compress PDF to 100 KB | {"mode":"targetSize","targetKb":100} |
| Compress PDF to 200 KB | {"mode":"targetSize","targetKb":200} |
| Compress PDF to 500 KB | {"mode":"targetSize","targetKb":500} |
| Compress PDF to 1 MB | {"mode":"targetSize","targetKb":1000} |
| Compress PDF to 2 MB | {"mode":"targetSize","targetKb":2000} |
| Compress PDF to 50 KB for SSC Upload | {"mode":"targetSize","targetKb":50} |
| Compress PDF to 200 KB for UPSC | {"mode":"targetSize","targetKb":200} |
| Compress PDF for NEET Application Upload | {"mode":"targetSize","targetKb":300} |
| Compress PDF for IBPS / SBI Bank Exam Upload | {"mode":"targetSize","targetKb":500} |
| Compress PDF to 1 MB for GST Portal | {"mode":"targetSize","targetKb":1000} |
| Compress PDF for DigiLocker Upload | {"mode":"targetSize","targetKb":1000} |
Try it yourself!
Pick a file, set the options and run a real request with your key. The code follows your changes.