API for developers
Every tool on this site is one HTTP request away. Send a multipart form, get the file back. No API key is needed; the public rate limit applies per IP address.
Base URL:
https://www.flipfloppdf.com/ · Max upload: 4 MB · Limit: see Retry-After on HTTP 429.Endpoint
POST /api/tools/<tool-id>
Content-Type: multipart/form-data
files one or more input files (repeat the field)
<option> any option listed for the tool, as a plain form field
image (watermark) the watermark image
signature (sign-pdf) a PNG of the signature
Successful responses are the resulting file (Content-Disposition: attachment). Errors are JSON: {"error": "message"} with status 400, 413, 429 or 500.
Examples
# Merge two PDFs
curl -F files=@a.pdf -F files=@b.pdf https://www.flipfloppdf.com/api/tools/merge-pdf -o merged.pdf
# Compress with the "extreme" preset
curl -F files=@big.pdf -F level=extreme https://www.flipfloppdf.com/api/tools/compress-pdf -o small.pdf
# PDF to Word (layout-exact engine)
curl -F file=@invoice.pdf https://www.flipfloppdf.com/convert -o invoice.docx -D - | grep -i x-conversion-engine
# Protect with a password
curl -F files=@doc.pdf -F password=secret -F print=true -F copy=false https://www.flipfloppdf.com/api/tools/protect-pdf -o protected.pdf
# Pages 2-4 as 150 dpi JPGs (ZIP)
curl -F files=@doc.pdf -F pages=2-4 -F dpi=150 https://www.flipfloppdf.com/api/tools/pdf-to-jpg -o pages.zip
Tool catalogue
The full list, including every option, its type, choices and default, is available as JSON at /api/tools.
| Tool id | Accepts | Files | Options |
|---|---|---|---|
merge-pdf | 2–50 | bookmarks | |
split-pdf | 1–1 | mode (ranges|every|chunks), ranges, chunk, merge_ranges | |
remove-pages | 1–1 | pages | |
extract-pages | 1–1 | pages, separate | |
organize-pdf | 1–1 | order, blank_size (A4|Letter) | |
scan-to-pdf | jpg, jpeg, png, webp, bmp, tif, tiff, gif | 1–100 | enhance (doc|gray|color), page (A4|Letter|fit), searchable |
compress-pdf | 1–20 | level (low|recommended|extreme) | |
repair-pdf | 1–20 | ||
jpg-to-pdf | jpg, jpeg, png, webp, bmp, tif, tiff, gif | 1–200 | page (fit|A4|Letter), orientation (auto|portrait|landscape), margin (none|small|big), merge |
html-to-pdf | html, htm | 0–1 | url, page (A4|Letter), orientation (portrait|landscape) |
txt-to-pdf | txt, text, log | 1–20 | page (A4|Letter), orientation (portrait|landscape), margin (none|small|big), font_size |
markdown-to-pdf | md, markdown, txt | 1–20 | page (A4|Letter), orientation (portrait|landscape), margin (none|small|big), font_size |
epub-to-pdf | epub, mobi, fb2, xps, oxps, cbz | 1–10 | page (A4|Letter), font_size |
pdf-to-jpg | 1–1 | mode (pages|extract), format (jpg|png|webp), dpi (96|150|300), pages | |
pdf-to-word | 1–1 | ||
pdf-to-excel | 1–1 | mode (tables|all), pages | |
pdf-to-markdown | 1–1 | pages, images | |
pdf-to-csv | 1–1 | output (combined|separate), pages, delimiter (comma|semicolon|tab|pipe), encoding (utf-8-sig|utf-8) | |
pdf-to-text | 1–20 | pages, page_marks | |
pdf-to-html | 1–1 | pages | |
pdf-to-png | 1–1 | dpi (96|150|300), pages | |
rotate-pdf | 1–20 | angle (90|180|270), pages | |
page-numbers | 1–1 | position (bottom-center|bottom-right|bottom-left|top-center|top-right|top-left), format ({n}|Page {n}|{n} / {N}|Page {n} of {N}), start, size, pages, color | |
watermark | 1–1 | kind (text|image), text, image, layout (diagonal|center|tile), size, opacity, color, pages | |
crop-pdf | 1–1 | mode (auto|margins), top, right, bottom, left, padding, pages | |
edit-pdf | 1–1 | ||
pdf-forms | 1–1 | flatten | |
unlock-pdf | 1–20 | password | |
protect-pdf | 1–20 | password, owner, print, copy, modify | |
sign-pdf | 1–1 | signature, page (last|first|all), position (bottom-right|bottom-left|bottom-center|top-right|top-left|center), width, date | |
redact-pdf | 1–1 | terms, emails, phones, cards, case, images | |
compare-pdf | 2–2 | ||
excel-to-csv | xlsx, xlsm, xls, ods | 1–20 | sheets (all|first), delimiter (comma|semicolon|tab|pipe), encoding (utf-8-sig|utf-8) |
csv-to-excel | csv, tsv, txt | 1–20 | delimiter (auto|comma|semicolon|tab|pipe), header, merge |
image-converter | jpg, jpeg, png, webp, bmp, tif, tiff, gif | 1–100 | format (jpg|png|webp), quality |
Note: pdf-to-word is also served at the original POST /convert endpoint with a single file field and returns an X-Conversion-Engine header.