§ Build and extract
Extract Images from PDF API
Returns the images stored inside a document, each in the format it was stored in — a JPEG stays a JPEG, with no re-encoding, so it is lossless and fast. Entries are named page-NNN-MM.ext, so an alphabetical listing is in document order.
- Endpoint
- POST /pdf/extract-images
- Inputs
- Exactly 1 PDF
- Returns
- application/zip
- Limits
- 500 images and 64 MB extracted, whichever comes first.
- Price
- $0.001
§ 01 The request
One POST, and the file comes back.
POST /pdf/extract-images
curl -sS --fail-with-body \
-o images.zip \
-H "Authorization: Bearer $OHMYWRAP_KEY" \
-F "file=@brochure.pdf" \
-F 'options={"pages":["1-2"]}' \
https://api.ohmywrap.com/pdf/extract-imagesOptions
| Option | Type | Default | What it does |
|---|---|---|---|
| pages | string[] | all pages | Page selection: "2", "2-4", "odd", "even", "3-", "-2". Ranges are clamped to the document. |
Worth knowing
This is not page rendering. It returns the images stored inside the document, not pictures of the pages, so a text-only PDF yields 422 no_images. Extracted images are never password protected, even from a protected document — a zip of images cannot carry PDF encryption.
Your first /pdf/extract-images call takes one line of curl.
Ten thousand calls cost ten dollars, the pack never expires, and nothing you send is kept.
10,000 calls for $10. No subscription, no expiry.