Reimply API

Optimize PDF API

Shrink a PDF to an exact byte cap by trying a light rewrite first, then stronger page compression, until it fits. If the cap cannot be reached, the job returns 422 target_unreachable with the smallest size achieved, and nothing is charged.

Example

Endpoint POST /v1/optimize. Options used here: max_bytes.

curl https://reimply.com/v1/optimize \
  -H "Authorization: Bearer $REIMPLY_API_KEY" \
  -H "Accept: application/octet-stream" \
  -F "file=@scan.pdf" \
  -F 'options={"max_bytes":100000}' \
  -o result

Files over 4 MB: create a presigned upload first and pass its upload_id, and the job runs in the background with an optional webhook.

Use cases

  • Forms that reject files over a set size
  • Email attachments with a hard cap
  • Keep document archives lean

Pricing

This job uses 1 conversion. Free accounts get 250 conversions a month, and paid plans start at £12 a month for 3,000. Pricing.

Questions

How many conversions does a Optimize PDF job use?

One conversion per file, whatever the size. Video and audio jobs use 3. Failed jobs are free.

What if the target size cannot be reached?

The job fails with 422 target_unreachable. The error includes the smallest size achieved (bytes_achieved) and nothing is charged.

Can I try it for free?

Yes. Every account gets 250 free conversions a month, no card needed. Create a key in your account and run the sample above.

What happens to my files?

Files are processed on Reimply servers and deleted automatically 60 minutes after the job, along with the results.

Just need to do this once? Use the free Optimize PDF tool on reimply.com.

More pdf endpoints