APIドキュメント

最初の分析

アカウントなしでPDF分析を試せます。アカウントの上限を適用して結果を保存するには、トークンを追加してください。

POST/api/v1/pdf/analyze

curl -X POST https://pdfcheck.online/api/v1/pdf/analyze \
  -H "Accept: application/json" \
  -F "file=@document.pdf"

コピーできませんでした。コードを選択して手動でコピーしてください。

認証: 任意
アップロード上限: 50 MB
ベースURL: https://pdfcheck.online/api/v1

認証

PDF分析ではトークンは任意です。アカウント情報、保存済みの分析、トークン管理にはBearerトークンが必要です。

トークンは秘密情報として扱ってください。環境変数を使い、不要なトークンはアカウントから失効させてください。 APIトークンを管理

curl -X POST https://pdfcheck.online/api/v1/pdf/analyze \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $PDFCHECK_API_TOKEN" \
  -F "file=@document.pdf"

コピーできませんでした。コードを選択して手動でコピーしてください。

使用量と上限

アカウントなし：IPアドレスごとに1日10回。Free：1日100回。ProとAI：1日の上限なし。処理エンドポイントには1分あたり30リクエストの上限もあります。分析レスポンスには残りのチェック回数が含まれます。

アクセス	1日の分析回数	アップロード上限
トークン不要	10	50 MB
Free	100	50 MB
Pro / AI	1日の上限なし	100 MB

処理エンドポイントには1分あたり30リクエストの上限もあります。429レスポンスは、1日または1分あたりの上限に達したことを示す場合があります。

POST`/pdf/analyze`

PDFファイルをアップロードして分析します。PDFから抽出された詳細なメタデータを返します。

名前	型	説明
`file`	multipart/form-data	必須. 分析するPDFファイル。アカウントなしとFreeは50 MBまで、ProとAIは100 MBまでです。

レスポンス例です。値はドキュメントによって異なります。

{
    "success": true,
    "data": {
        "id": "example-analysis-token",
        "view_key": "example-view-key",
        "filename": "document.pdf",
        "file_size": 1048576,
        "file_size_formatted": "1.00 MB",
        "metadata": {
            "basic": {
                "pages": 10,
                "pdf_version": "1.7",
                "analysis_mode": "lightweight",
                "partial_analysis": true
            },
            "document": {
                "title": "Example document",
                "author": "Example author",
                "creator": "Microsoft Word",
                "producer": "Adobe PDF Library"
            }
        },
        "analyzed_at": "2026-09-29T12:00:00+00:00"
    },
    "remaining_checks": 9
}

コピーできませんでした。コードを選択して手動でコピーしてください。

APIのメタデータ分析では、処理を制限した軽量モードを使います。フォント、画像、色の詳細な分析は省略され、metadata.basic.partial_analysisはtrueになります。

メタデータやソフトウェアの指標は、著作者、真正性、規格への適合を証明するものではありません。

アップロードしたファイルのデータは処理後に削除されます。分析結果やメタデータは保持される場合があります。プライバシーポリシーをご覧ください。プライバシーポリシー

GET`/user`

認証済みユーザーの情報（1日の使用制限を含む）を取得します。

トークン必須. レスポンス例です。値はドキュメントによって異なります。

{
    "success": true,
    "data": {
        "name": "Example user",
        "email": "user@example.com",
        "daily_limit": 100,
        "remaining_checks": 99,
        "checks_used_today": 1
    }
}

コピーできませんでした。コードを選択して手動でコピーしてください。

GET`/pdf`

認証済みユーザーの全PDF分析結果をページネーション付きで一覧表示します。

トークン必須

クエリパラメータ	デフォルト	説明
`per_page`	20	ページあたりの結果数（1〜100）
`page`	1	integer

{
    "success": true,
    "data": [
        {
            "id": "example-analysis-token",
            "filename": "document.pdf",
            "file_size": 1048576,
            "file_size_formatted": "1.00 MB",
            "analyzed_at": "2026-09-29T12:00:00+00:00"
        }
    ],
    "meta": {
        "current_page": 1,
        "last_page": 1,
        "per_page": 20,
        "total": 1
    }
}

コピーできませんでした。コードを選択して手動でコピーしてください。

GET`/pdf/{token}`

分析ID（共有トークン）による詳細な分析結果を取得します。

トークン必須

curl https://pdfcheck.online/api/v1/pdf/example-analysis-token \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $PDFCHECK_API_TOKEN"

コピーできませんでした。コードを選択して手動でコピーしてください。

エンドポイントリファレンス

POST`/pdf/extract-text`

PDFからテキストを抽出します。ファイルはpdfフィールドで送信してください。このエンドポイントのアップロード上限は50 MBで、data.pagesを返します。

curl -X POST https://pdfcheck.online/api/v1/pdf/extract-text \
  -H "Accept: application/json" \
  -F "pdf=@document.pdf"

コピーできませんでした。コードを選択して手動でコピーしてください。

POST`/pdf/to-markdown`

PDFをMarkdownに変換します。ファイルはpdfフィールドで送信してください（上限50 MB）。別の利用枠として、アカウントなしとFreeは1日10回、ProとAIは1日100回まで変換できます。スキャンしたページには外部のAI OCRを使う場合があります。レスポンスにはremaining_conversionsが含まれます。

curl -X POST https://pdfcheck.online/api/v1/pdf/to-markdown \
  -H "Accept: application/json" \
  -F "pdf=@document.pdf"

コピーできませんでした。コードを選択して手動でコピーしてください。

トークン管理

API経由でトークンを作成するには、既存のトークンが必要です。最初のトークンはアカウントから作成してください。 APIトークンを管理

エンドポイント	説明
`GET /tokens`	認証済みユーザーの全APIトークンを一覧表示します。
`POST /tokens`	新しいAPIトークンを作成します。トークンはレスポンスで一度だけ表示されます。 `name: string (max: 255)`
`DELETE /tokens/{tokenId}`	APIトークンを永久に取り消し（削除）します。

curl -X POST https://pdfcheck.online/api/v1/tokens \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $PDFCHECK_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"My integration"}'

コピーできませんでした。コードを選択して手動でコピーしてください。

エラーコード

HTTPコード	エラーコード	説明
401	`Unauthenticated.`	無効または欠落したAPIトークン
404	`not_found`	リソースが見つからないか、アクセスが拒否されました
422	`message / errors` `corrupted_pdf` `password_protected` `analysis_failed`	無効なリクエストまたはPDF処理の失敗。未対応のファイル、アップロード上限超過、破損したPDF、パスワード保護などが該当します
429	`daily_limit_exceeded` `message`	1日または1分あたりの上限に達しました。該当する上限がリセットされてから再試行してください

コード例

結果はdata.metadata.basic.pagesから読み取ります。すべてのレスポンス例は説明用です。

Node.js 20以降。標準のfetch、FormData、Blobを使用します。

import { readFile } from 'node:fs/promises';

const form = new FormData();
form.append('file', new Blob([await readFile('document.pdf')], {
  type: 'application/pdf'
}), 'document.pdf');

const headers = { Accept: 'application/json' };
if (process.env.PDFCHECK_API_TOKEN) {
  headers.Authorization = `Bearer ${process.env.PDFCHECK_API_TOKEN}`;
}

const response = await fetch('https://pdfcheck.online/api/v1/pdf/analyze', {
  method: 'POST', headers, body: form
});
const result = await response.json();
if (!response.ok || !result.success) throw new Error(JSON.stringify(result));
console.log(result.data.metadata.basic.pages);
console.log(result.remaining_checks);

コピーできませんでした。コードを選択して手動でコピーしてください。

Python (requests)

import os
import requests

headers = {'Accept': 'application/json'}
if os.getenv('PDFCHECK_API_TOKEN'):
    headers['Authorization'] = f"Bearer {os.environ['PDFCHECK_API_TOKEN']}"

with open('document.pdf', 'rb') as pdf:
    response = requests.post(
        'https://pdfcheck.online/api/v1/pdf/analyze',
        headers=headers,
        files={'file': ('document.pdf', pdf, 'application/pdf')},
        timeout=120,
    )
response.raise_for_status()
result = response.json()
print(result['data']['metadata']['basic']['pages'])
print(result['remaining_checks'])

コピーできませんでした。コードを選択して手動でコピーしてください。

PHP (cURL)

<?php
$headers = ['Accept: application/json'];
if ($token = getenv('PDFCHECK_API_TOKEN')) {
    $headers[] = 'Authorization: Bearer ' . $token;
}
$curl = curl_init('https://pdfcheck.online/api/v1/pdf/analyze');
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => ['file' => new CURLFile('document.pdf', 'application/pdf')],
]);
$body = curl_exec($curl);
if ($body === false) throw new RuntimeException(curl_error($curl));
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
$result = json_decode($body, true, flags: JSON_THROW_ON_ERROR);
if ($status >= 400 || !($result['success'] ?? false)) {
    throw new RuntimeException($body);
}
echo $result['data']['metadata']['basic']['pages'];

コピーできませんでした。コードを選択して手動でコピーしてください。

PDF分析

PDF最適化

PDFを変換

作成・編集

リソースとテンプレート

すべてのPDFツール

APIドキュメント

最初の分析

認証

使用量と上限

POST`/pdf/analyze`

GET`/user`

GET`/pdf`

GET`/pdf/{token}`

エンドポイントリファレンス

POST`/pdf/extract-text`

POST`/pdf/to-markdown`

トークン管理

エラーコード

コード例

PDFCheckを後で使えるように保存

必須Cookieのみ

最初の分析

認証

使用量と上限

POST/pdf/analyze

GET/user

GET/pdf

GET/pdf/{token}

エンドポイントリファレンス

POST/pdf/extract-text

POST/pdf/to-markdown

トークン管理

エラーコード

コード例

POST`/pdf/analyze`

GET`/user`

GET`/pdf`

GET`/pdf/{token}`

POST`/pdf/extract-text`

POST`/pdf/to-markdown`