SmallPDF.us
開発者向け API · v1

開発者のために作られたPDF API

タスクごとにシンプルなRESTエンドポイントを1つ。PDFの結合・変換・圧縮・保護をどの言語からでも — SDKなし、サーバー不要、PDFライブラリ不要。

無料APIキーを取得クイックスタート
11エンドポイント
PDF・Word・画像
SDKなし
シンプルなHTTP + multipart
プライベート
スキャン後自動削除
あらゆる言語
cURL、Node、Python…

クイックスタート

1. キーを取得

ダッシュボードでサインインしてキーを作成。

2. エンドポイントを呼び出す

multipart/form-dataでファイルをPOST。

3. 結果を取得

処理済みファイルがすぐにストリームで返される。

Request
curl -X POST https://smallpdf.us/api/v1/merge \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "files=@image1.pdf" \
  -F "files=@image2.pdf" \
  -o merged.pdf

認証

すべてのリクエストにシークレットキーを X-API-Key ヘッダーに含めてください。 ダッシュボード. キーはサーバーサイドで管理 — クライアントコードに公開しないでください。

Request
X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

ベースURL・レスポンス

すべてのエンドポイントは POST 以下に

https://smallpdf.us/api/v1
  • 成功時は処理済みファイルがボディで直接返されます。
  • エラー時はJSONボディが返されます: { "error": "...", "code": "..." }
  • すべてのレスポンスには X-RateLimit-Limit / X-RateLimit-Remaining
  • アップロードはマルウェアスキャン後、処理完了直後にサーバーから削除されます。

エンドポイント

整理

POST/v1/mergeMerge PDF

Combine two or more PDFs into a single document, in the order provided.

パラメータ

filesfile[]必須

Two or more PDF files.

返り値: PDF file · merged.pdf

Request
curl -X POST https://smallpdf.us/api/v1/merge \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "files=@image1.pdf" \
  -F "files=@image2.pdf" \
  -o merged.pdf
POST/v1/splitSplit PDF

Split a PDF. Without `pages` you receive a ZIP with one PDF per page; with `pages` you receive a single PDF of just those pages.

パラメータ

filefile必須

The PDF to split.

pagesstring任意

Optional range, e.g. "1,3,5-7".

返り値: PDF file · split.pdf

Request
curl -X POST https://smallpdf.us/api/v1/split \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@input.pdf" \
  -F "pages=1-3" \
  -o split.pdf
POST/v1/rotateRotate PDF

Rotate every page by a multiple of 90 degrees.

パラメータ

filefile必須

The PDF to rotate.

angleint任意

90, 180 or 270. Default 90.

返り値: PDF file · rotated.pdf

Request
curl -X POST https://smallpdf.us/api/v1/rotate \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@input.pdf" \
  -F "angle=90" \
  -o rotated.pdf

変換

POST/v1/pdf-to-wordPDF to Word

Convert a PDF into an editable Word (.docx) document with layout preserved.

パラメータ

filefile必須

The PDF to convert.

返り値: Word .docx file · converted.docx

Request
curl -X POST https://smallpdf.us/api/v1/pdf-to-word \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@input.pdf" \
  -o converted.docx
POST/v1/word-to-pdfWord to PDF

Convert a Word document (.doc, .docx, .odt, .rtf) into a PDF.

パラメータ

filefile必須

The document to convert.

返り値: PDF file · converted.pdf

Request
curl -X POST https://smallpdf.us/api/v1/word-to-pdf \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@input.docx" \
  -o converted.pdf
POST/v1/pdf-to-jpgPDF to JPG

Render each PDF page to a JPG image. Returns a ZIP archive.

パラメータ

filefile必須

The PDF to convert.

qualitystring任意

standard (150dpi) · high (300) · maximum (600).

返り値: ZIP archive of images · pages.zip

Request
curl -X POST https://smallpdf.us/api/v1/pdf-to-jpg \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@input.pdf" \
  -F "quality=high" \
  -o pages.zip
POST/v1/pdf-to-pngPDF to PNG

Render each PDF page to a PNG image. Returns a ZIP archive.

パラメータ

filefile必須

The PDF to convert.

qualitystring任意

standard · high · maximum.

返り値: ZIP archive of images · pages.zip

Request
curl -X POST https://smallpdf.us/api/v1/pdf-to-png \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@input.pdf" \
  -F "quality=high" \
  -o pages.zip
POST/v1/jpg-to-pdfJPG to PDF

Combine one or more JPG images into a single PDF (one image per page).

パラメータ

filesfile[]必須

One or more JPG images.

返り値: PDF file · images.pdf

Request
curl -X POST https://smallpdf.us/api/v1/jpg-to-pdf \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "files=@image1.jpg" \
  -F "files=@image2.jpg" \
  -o images.pdf
POST/v1/png-to-pdfPNG to PDF

Combine one or more PNG images into a single PDF (one image per page).

パラメータ

filesfile[]必須

One or more PNG images.

返り値: PDF file · images.pdf

Request
curl -X POST https://smallpdf.us/api/v1/png-to-pdf \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "files=@image1.png" \
  -F "files=@image2.png" \
  -o images.pdf

最適化

POST/v1/compressCompress PDF

Reduce a PDF's file size with lossless stream compression.

パラメータ

filefile必須

The PDF to compress.

返り値: PDF file · compressed.pdf

Request
curl -X POST https://smallpdf.us/api/v1/compress \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@input.pdf" \
  -o compressed.pdf

セキュリティ

POST/v1/protectProtect PDF

Encrypt a PDF with AES-256 so it can only be opened with the password.

パラメータ

filefile必須

The PDF to protect.

passwordstring必須

Password required to open the file.

返り値: PDF file · protected.pdf

Request
curl -X POST https://smallpdf.us/api/v1/protect \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@input.pdf" \
  -F "password=secret123" \
  -o protected.pdf

プランとクォータ

プランAPI呼び出し価格
Free50 / month$0
Starter1,000 / month$9/mo
Pro10,000 / month$19/mo
Max100,000 / monthContact sales

クォータは毎月1日（UTC）にリセット。成功した呼び出しのみカウント。 詳細な料金を見る →

ステータスコード・エラーコード

HTTPコード意味
200—Success. The processed file is returned in the body.
400BAD_INPUTMissing or invalid file / parameters.
401NO_API_KEY · BAD_API_KEYMissing, invalid or revoked key.
429QUOTA_EXCEEDEDMonthly quota used up — upgrade your plan.
500PROCESSING_ERRORThe file could not be processed.

今すぐ開発を始める

無料APIキーを作成して1分以内に最初のリクエストを送信。

APIキーを取得