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 idAcceptsFilesOptions
merge-pdfpdf2–50 bookmarks
split-pdfpdf1–1 mode (ranges|every|chunks), ranges, chunk, merge_ranges
remove-pagespdf1–1 pages
extract-pagespdf1–1 pages, separate
organize-pdfpdf1–1 order, blank_size (A4|Letter)
scan-to-pdfjpg, jpeg, png, webp, bmp, tif, tiff, gif1–100 enhance (doc|gray|color), page (A4|Letter|fit), searchable
compress-pdfpdf1–20 level (low|recommended|extreme)
repair-pdfpdf1–20
jpg-to-pdfjpg, jpeg, png, webp, bmp, tif, tiff, gif1–200 page (fit|A4|Letter), orientation (auto|portrait|landscape), margin (none|small|big), merge
html-to-pdfhtml, htm0–1 url, page (A4|Letter), orientation (portrait|landscape)
txt-to-pdftxt, text, log1–20 page (A4|Letter), orientation (portrait|landscape), margin (none|small|big), font_size
markdown-to-pdfmd, markdown, txt1–20 page (A4|Letter), orientation (portrait|landscape), margin (none|small|big), font_size
epub-to-pdfepub, mobi, fb2, xps, oxps, cbz1–10 page (A4|Letter), font_size
pdf-to-jpgpdf1–1 mode (pages|extract), format (jpg|png|webp), dpi (96|150|300), pages
pdf-to-wordpdf1–1
pdf-to-excelpdf1–1 mode (tables|all), pages
pdf-to-markdownpdf1–1 pages, images
pdf-to-csvpdf1–1 output (combined|separate), pages, delimiter (comma|semicolon|tab|pipe), encoding (utf-8-sig|utf-8)
pdf-to-textpdf1–20 pages, page_marks
pdf-to-htmlpdf1–1 pages
pdf-to-pngpdf1–1 dpi (96|150|300), pages
rotate-pdfpdf1–20 angle (90|180|270), pages
page-numberspdf1–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
watermarkpdf1–1 kind (text|image), text, image, layout (diagonal|center|tile), size, opacity, color, pages
crop-pdfpdf1–1 mode (auto|margins), top, right, bottom, left, padding, pages
edit-pdfpdf1–1
pdf-formspdf1–1 flatten
unlock-pdfpdf1–20 password
protect-pdfpdf1–20 password, owner, print, copy, modify
sign-pdfpdf1–1 signature, page (last|first|all), position (bottom-right|bottom-left|bottom-center|top-right|top-left|center), width, date
redact-pdfpdf1–1 terms, emails, phones, cards, case, images
compare-pdfpdf2–2
excel-to-csvxlsx, xlsm, xls, ods1–20 sheets (all|first), delimiter (comma|semicolon|tab|pipe), encoding (utf-8-sig|utf-8)
csv-to-excelcsv, tsv, txt1–20 delimiter (auto|comma|semicolon|tab|pipe), header, merge
image-converterjpg, jpeg, png, webp, bmp, tif, tiff, gif1–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.