メインコンテンツへ移動

次に使うツールを探す

ダッシュボードAndroid アプリ
言語
表示
開発者向け API と自動化

MAXScanner で文書の自動化を構築

文書の変換、結合、OCR のための REST API。Zapier、Make、n8n にも本格対応しています。無料で始められ、クレジットカードは不要です。

クイックスタート

  1. サインインしてダッシュボードを開き、API と自動化 → API キー → 新しいキーを作成に進みます。
  2. キーをコピーします（表示は一度だけです）。形式は mxs_xxxxxxxx_xxxxxxxxxxxx のようになります。
  3. すべてのリクエストで Bearer トークンとして送信します: Authorization: Bearer YOUR_API_KEY。
curl -X POST https://maxscanner.app/api/v1/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/report.docx","filename":"report.docx","format":"pdf"}' \
  --output report.pdf
ライブ

今すぐ API を試す

実際の /api/v1/sandbox/convert エンドポイントを呼び出し、その場で生成した小さなデモ文書を変換します。API キーは不要です。また maxscanner.app 上のこのページからしか動作しないため、他のサイトに埋め込んだり悪用したりはできません。

利用上限と無料クレジット

無料プラン

1 日 10 回

月 100 リクエストまで、ずっと無料。クレジットカードは不要です。

有料プラン

2,000 回〜無制限

Starter（月 2,000 クレジット）、Pro（月 10,000）、Business（無制限）。

有料プランでは操作ごとにクレジットを消費します:

変換 — 2 クレジット結合 — 1 クレジットOCR — 3 クレジット利用状況の確認 — 無料

エンドポイント

ベース URL: https://maxscanner.app/api/v1

GET/health無料・キー不要

API が稼働しているか確認します。Zapier の「接続テスト」ステップに便利です。

レスポンス

{ "status": "ok", "service": "MAXScanner Public API", "version": "v1" }
GET/usage無料

送信したキーの現在のプランと残りの利用枠を確認します。

レスポンス

{ "plan": "Free", "limits": { "per_day": 10, "per_month": 100 },
  "remaining": { "today": 7, "this_month": 84 } }
POST/convert2 クレジット

URL 上の文書を別の形式（pdf、docx、xlsx、pptx、txt、html、png など）に変換します。

リクエスト本文

{ "url": "https://example.com/report.docx",
  "filename": "report.docx", "format": "pdf" }

レスポンス

バイナリファイル（Content-Type は指定した形式に一致）
POST/merge1 クレジット

URL で指定した 2〜20 個の PDF を、指定した順に 1 つの PDF に結合します。

リクエスト本文

{ "files": ["https://.../page1.pdf", "https://.../page2.pdf"] }

レスポンス

バイナリファイル (application/pdf)
POST/ocr3 クレジット

スキャン画像や PDF から本物の OCR でテキストを抽出します。テキストレイヤーがまったくなくても動作します。

リクエスト本文

{ "url": "https://.../scan.pdf", "filename": "scan.pdf", "language": "eng" }

レスポンス

{ "text": "...", "pages": 3, "language": "eng" }
POST/documents/import1 クレジット

自動化からファイルを MAXScanner のライブラリへ取り込みます。/convert とは逆方向です。

リクエスト本文

{ "url": "https://.../invoice.pdf", "filename": "invoice.pdf" }

レスポンス

{ "id": "...", "filename": "invoice.pdf", "downloadUrl": "..." }
POST/hooks/subscribe無料

1 種類のイベントを今後受け取るための Webhook URL を登録します。下の「Webhook、Zapier、n8n」をご覧ください。

リクエスト本文

{ "event": "scan.created", "targetUrl": "https://hooks.zapier.com/..." }

レスポンス

{ "id": "...", "event": "scan.created", "targetUrl": "..." }
POST/hooks/unsubscribe無料

id を指定して Webhook の購読を解除します。

リクエスト本文

{ "id": "..." }

レスポンス

{ "success": true }
GET/hooks無料

有効な Webhook の購読を、それぞれの最終配信ステータスとともに一覧表示します。

レスポンス

{ "subscriptions": [{ "id": "...", "event": "scan.created", "targetUrl": "..." }] }

/convert の対応形式（Office 形式だけではありません）

Word / Excel / PowerPointPDF定番の「Office から PDF」
PDFWord / テキスト / HTML「PDF から Office」
PDFPNG / JPG 画像1 ページにつき 1 枚
PNG / JPG 画像PDF画像を PDF ページにする

Zapier、Make、n8n、Webhook

MAXScanner Android アプリを 5,000 以上のアプリと連携できます。アプリで 設定 → Zapier と自動化（またはツールの API と自動化 タイル）を開いて登録し、連携キーを取得してください。そのキーを Zapier の接続ステップで MAXScanner API キーとして使えます。同じキーは上の REST 直接呼び出しにも使えます。

利用できるトリガー

新しいスキャン文書scan.createdすべてのプラン

アプリで新しい文書をスキャンするたびに発生します。

新しい PDF エクスポートpdf.exportedすべてのプラン

文書グループが PDF にエクスポートされたときに発生します。

新しい位置情報付きスキャンgeotag.capturedPro 以上

位置情報（住所、市区町村、座標）付きのスキャンで発生します。

新しいタイムスタンプ付き撮影timestamp.capturedBusiness

タイムスタンプ付きの撮影で発生します。

新しい OCR テキスト抽出ocr.completedPro 以上

スキャンの端末内 OCR テキストが利用可能になったときに発生します。

新しい QR コードの読み取りqr.scannedすべてのプラン

アプリで QR コードを読み取った瞬間に、デコードしたテキストとともに発生します。

Make.com

ビジュアルな自動化シナリオ

n8n

セルフホスト型のワークフロー自動化

Webhook

それ以外のための HTTP コールバック

3 つのプラットフォームはどれも同じ仕組みです。各サービスが URL を発行し、/hooks/subscribe で MAXScanner にその URL への POST を指示します。Zapier のネイティブアプリはまだありませんが、今すぐ使える Zapier 標準の Webhooks by Zapier アクションを利用します。

⚡ Zapier の手順

  1. Zap を作成 → Webhooks by Zapier アプリを検索 → トリガーイベント Catch Hook を選びます。
  2. Zapier に専用の Webhook URL（例: https://hooks.zapier.com/hooks/catch/...）が表示されるので、コピーします。
  3. その URL と必要なイベントを指定して、MAXScanner の /hooks/subscribe を 1 回呼び出します（下の curl の例を参照）。
  4. Zapier に戻り、アプリでテストイベントを発生させます（例: 文書をスキャン）。Catch Hook ステップにサンプルデータが表示されるはずです。そこから Zap のアクション（Google ドライブ、スプレッドシート、Slack、メールなど）を作り込みます。

🔄 n8n の手順

  1. 新しいワークフローに Webhook トリガーノードを追加し、POST リクエストを受け付けるよう設定します。
  2. ノードの Production URL をコピーします（先にワークフローを有効化して稼働させてください）。
  3. その URL と選んだイベントを指定して /hooks/subscribe を呼び出します。
  4. アプリでテストイベントを発生させると、Webhook ノードがペイロードを受け取り、ワークフローの続きにつなげられます。

curl で購読する

curl -X POST https://maxscanner.app/api/v1/hooks/subscribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event":"scan.created","targetUrl":"https://hooks.zapier.com/hooks/catch/.../..."}'

文書の自動化を始めませんか？

無料の API キーを作成: 1 日 10 リクエスト、月 100 リクエスト、カード不要。