概要
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の一覧表
| ベースURL | https://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ステップで完了、記入するフォームはありません。最も時間がかかるのは、チャージ分のブロックチェーン確認です。
暗号資産でチャージ
BTC, USDT, USDC, ETH, SOL, LTCで$25以上を送金してください。アカウント番号でログイン。メールは任意。
クレジットパックを購入する
$3.75あたり10,000ページあれば、ご自身のURLで全オプションを試せます。
APIキーをコピー
暗号資産でのチャージが確認され、パックを購入すると、ダッシュボードでAPIキーが使用可能になります。
WEBREADER_API_KEYという名前の環境変数に保存してください。
最初のリクエストはどのような形ですか?
ページアドレスをurlパラメータに入れた、シンプルなHTTPS GETです。アドレスには:や/の文字が含まれるため、エンコードしてください。curlでは--data-urlencodeを付ければ自動で処理されます。デフォルト設定はほとんどの記事やドキュメントページにそのまま適しています。Markdown出力、本文のみ、そしてページに必要な場合のみブラウザを使用します。
curl -sG "https://webreaderapi.com/api/v1/read" \
-H "Authorization: Bearer $WEBREADER_API_KEY" \
--data-urlencode "url=https://example.com/blog/first-post"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"])
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つのパラメータでほとんどのニーズをカバーできます。すべて任意です。
| パラメータ | 用途 |
|---|---|
format | markdownの代わりにtextやクリーンアップしたhtmlを取得 |
main_content | falseを設定してメニューを含むページ全体を変換 |
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では、再試行すべきエラーと最終的なエラーを説明しています。
次に何をすればよいですか?
- endpoint referenceを読む /readの全パラメータと例
- バッチとクロール バッチあたり最大100 URL、またはサイト全体
- レスポンス形式 レスポンスの全フィールド
- エラーとrobots.txt コード、原因、再試行ルール
- Python requests、async httpx、RAGチャンキング
- Node.js fetch、小さなプール、クロールのポーリング
- curlとjq ターミナル向けレシピ
- MCPサーバー ClaudeとCursor向けのread_urlツール
- LangChainとLlamaIndex RAG向けのローダーとツール
- OpenAI function calling read_urlツールのスキーマとループ
- n8n AI Agent向けHTTP Requestツール
- OpenClaw web_fetchの隣にMCPサーバーを追加
クイックスタート: よくある質問
インストールする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で返金できます。