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 resultimport { readFile, writeFile } from 'node:fs/promises'
const form = new FormData()
form.append('file', new Blob([await readFile('scan.pdf')]), 'scan.pdf')
form.append('options', JSON.stringify({"max_bytes":100000}))
const res = await fetch('https://reimply.com/v1/optimize', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.REIMPLY_API_KEY}` },
body: form,
})
const job = await res.json()
if (!res.ok) throw new Error(job.error.message)
for (const o of job.outputs) {
const file = await fetch(o.url)
await writeFile(o.name, Buffer.from(await file.arrayBuffer()))
}
console.log(job.id, 'used', job.credits.charged, 'credit(s)')import os, requests
with open("scan.pdf", "rb") as f:
res = requests.post(
"https://reimply.com/v1/optimize",
headers={"Authorization": f"Bearer {os.environ['REIMPLY_API_KEY']}"},
files={"file": f},
data={"options": '{"max_bytes":100000}'},
)
job = res.json()
res.raise_for_status()
for o in job["outputs"]:
with open(o["name"], "wb") as out:
out.write(requests.get(o["url"]).content)
print(job["id"], "used", job["credits"]["charged"], "credit(s)")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
Cette tâche utilise 1 conversion. Les comptes gratuits ont 250 conversions par mois, et les offres payantes commencent à 12 £ par mois pour 3 000. Tarifs.
Questions
Combien de conversions utilise une tâche Optimize PDF ?
Une conversion par fichier, quelle que soit la taille. Les tâches vidéo et audio en utilisent 3. Les tâches en échec sont gratuites.
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.
Puis-je l’essayer gratuitement ?
Oui. Chaque compte reçoit 250 conversions gratuites par mois, sans carte. Créez une clé dans votre compte et lancez l’exemple ci-dessus.
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.