KYC不要 — 身分証もセルフィーも書類も不要。暗号資産で支払い:BTC, USDT, USDC, ETH, SOL, LTC
言語: 日本語
APIキーを取得

Docs · クイックスタート

URL to Markdown API クイックスタート:2分で最初のページを取得

エンドポイントは1つ、パラメータも1つ:URLを/readに送ると、ページの本文がMarkdownで返ってきます。このページでは残高ゼロから実際に呼び出せる状態まで導き、その後ほかのすべての情報へ案内します。

最終更新:

概要

APIでURLをMarkdownに変換するには?

URLをAuthorizationヘッダーにAPIキーを付けてGET https://webreaderapi.com/api/v1/readに送ってください。WebReaderAPIがページを取得し、本文を保持して、タイトル、著者、日付、単語数とともにMarkdownとして返します。1ページにつき1クレジット(ブラウザが必要な場合は2クレジット)で、2026年10月時点では$0.07/1Kページから。KYC不要、暗号資産で支払い。

APIの一覧表

ベースURLhttps://webreaderapi.com/api/v1
1ページを読み取るGETまたはPOST https://webreaderapi.com/api/v1/read
複数のURLまたはサイトPOST https://webreaderapi.com/api/v1/batchとPOST https://webreaderapi.com/api/v1/crawl、結果はGET https://webreaderapi.com/api/v1/jobs/{job_id}から
残高クレジットGET https://webreaderapi.com/api/v1/credits(無料)
認証APIキーはAuthorizationヘッダーにBearerトークンとして、またはapi_keyクエリパラメータで送信してください
課金1クレジット = ブラウザなしでページを1回読み取り。ページのJavaScriptレンダリングにブラウザが必要な場合は2クレジット。失敗したリクエスト、またはサイトのrobots.txtが拒否したリクエストは課金されません
当社のクローラーWebReaderAPI/1.0 (+https://webreaderapi.com/bot/)、robots.txtトークンWebReaderAPI
最小パック$3.75で10,000ページ、クレジットは無期限

APIキーはどう取得しますか?

3ステップで完了、記入するフォームはありません。最も時間がかかるのは、チャージ分のブロックチェーン確認です。

  1. 暗号資産でチャージ

    BTC, USDT, USDC, ETH, SOL, LTCで$25以上を送金してください。アカウント番号でログイン。メールは任意。

  2. クレジットパックを購入する

    $3.75あたり10,000ページあれば、ご自身のURLで全オプションを試せます。

  3. APIキーをコピー

    暗号資産でのチャージが確認され、パックを購入すると、ダッシュボードでAPIキーが使用可能になります。WEBREADER_API_KEYという名前の環境変数に保存してください。

最初のリクエストはどのような形ですか?

ページアドレスをurlパラメータに入れた、シンプルなHTTPS GETです。アドレスには:や/の文字が含まれるため、エンコードしてください。curlでは--data-urlencodeを付ければ自動で処理されます。デフォルト設定はほとんどの記事やドキュメントページにそのまま適しています。Markdown出力、本文のみ、そしてページに必要な場合のみブラウザを使用します。

curl: 1ページを読み取る
curl -sG "https://webreaderapi.com/api/v1/read" \
  -H "Authorization: Bearer $WEBREADER_API_KEY" \
  --data-urlencode "url=https://example.com/blog/first-post"
Python: 1ページを読み取って保存する
import os

import requests

resp = requests.get(
    "https://webreaderapi.com/api/v1/read",
    headers={"Authorization": "Bearer " + os.environ["WEBREADER_API_KEY"]},
    params={"url": "https://example.com/blog/first-post"},
    timeout=70,
)
resp.raise_for_status()
page = resp.json()
print(page["title"], "-", page["word_count"], "words,", page["credits_used"], "credit(s)")
with open("first-post.md", "w", encoding="utf-8") as f:
    f.write(page["markdown"])
Node.js 18+: 1ページを読み取る
const params = new URLSearchParams({ url: 'https://example.com/blog/first-post' });
const res = await fetch(`https://webreaderapi.com/api/v1/read?${params}`, {
  headers: { Authorization: `Bearer ${process.env.WEBREADER_API_KEY}` },
});
const page = await res.json();
if (!res.ok) throw new Error(`${page.error.code}: ${page.error.message}`);
console.log(page.title, page.word_count, 'words');
console.log(page.markdown.slice(0, 500));

何が返ってきますか?

markdownフィールドにMarkdown、その隣にページのメタデータを含むJSONオブジェクトです: title、description、author、published_at、language、site_name、word_count。何が起きたかを確認できるフィールドが2つあります: final_urlはリダイレクト後のアドレス、renderedはブラウザが必要だったかどうかを示します。

credits_usedは呼び出しのコストを示します: 通常のページは1、renderedがtrueのときは2、countryを選んだ場合はさらに1。 response formatページには全フィールドが例付きで掲載されています。

どのオプションを最もよく使いますか?

5つのパラメータでほとんどのニーズをカバーできます。すべて任意です。

パラメータ用途
formatmarkdownの代わりにtextやクリーンアップしたhtmlを取得
main_contentfalseを設定してメニューを含むページ全体を変換
renderブラウザを強制(true)または禁止(false)。autoが自動判断
include_linksページのリンクを別リストとして取得
max_chars長いページをモデルのコンテキスト予算に収まるようカット

read referenceにはcountry、include_images、timeoutを含む全パラメータが記載されています。

残りのクレジットはどう確認しますか?

同じキーでGET https://webreaderapi.com/api/v1/creditsを呼び出してください。credits_remaining、credits_used_today、concurrency_limitを返し、コストはかかりません。長時間のジョブの開始時に実行すれば、途中で402 insufficient_creditsにより失敗するのではなく、クリーンに停止できます。

プリペイドクレジットに有効期限はありません。未使用のページは使うまでアカウントに残りますため、あるプロジェクト用に購入したパックは次のプロジェクトでもその価値を保ちます。

サイトがrobotsを許可していない場合はどうなりますか?

ページを読み取らず、課金もされません。当社のクローラーはWebReaderAPI/1.0 (+https://webreaderapi.com/bot/)として名乗り、サイトのrobots.txtに従います。許可されていないページには403 blocked_by_robotsを返し、別の方法でリクエストを拒否するサイトにはそのサイト自身のステータスコードとともに502 target_refusedを返します。

サイトが当社のリクエストを拒否した場合、その回答をそのまま返します。CAPTCHAを解いたり、アカウントにログインしたり、ブロックやペイウォールを回避しようとしたりすることは決してありません。errors pageでは、再試行すべきエラーと最終的なエラーを説明しています。

次に何をすればよいですか?

クイックスタート: よくある質問

インストールするSDKはありますか?

いいえ。WebReaderAPIはシンプルなHTTPS APIなので、どのHTTPクライアントでも動作します。ドキュメントにはPython、Node.js、curl向けのコピー&ペースト用コードと、MCP、LangChain、LlamaIndex、OpenAI function calling向けのツール定義が掲載されています。パッケージとして公開されているものはありません。

キーをヘッダーではなくURLで送れますか?

はい、api_keyクエリパラメータとして送れます。Authorization: Bearerヘッダーの方が安全です。URLはログやブラウザ履歴に残ることが多いためです。APIキーは複数作成できます(例:エージェントやプロジェクトごとに1つ)。ダッシュボードからいつでも失効できます。

失敗したページでクレジットは消費されますか?

いいえ。1クレジット = ブラウザなしでページを1回読み取り。ページのJavaScriptレンダリングにブラウザが必要な場合は2クレジット。失敗したリクエスト、またはサイトのrobots.txtが拒否したリクエストは課金されません。コンテンツが返ってきたページのみ課金されます。

購入前に試せますか?

無料枠はありません。無料プランはありません。最小パックがテスト手段で、最低チャージ額から支払います。最低チャージ額に到達するためだけに追加した金額は、未使用であれば30日以内にリクエストによりUSDTまたはUSDCで返金できます。

$0.07/1Kページから · KYC不要

APIキーを取得