クイック回答
AIエージェント向けWeb検索APIで最初の検索を実行するには?
あなたのAPIキーをBearerトークンとして付けて、質問をPOST https://llmwebsearch.com/api/v1/searchに送ります。LLMWebSearchがライブWeb検索を実行し、最大20件のランキング結果を返します。最初の3ページは読み取られ、Markdownとして返されます。1クレジットでその呼び出し全体をまかないます(2026年10月時点で$1.20/1K検索から)。KYC不要、暗号資産で支払い。
1枚のカードでわかるAPI
| ベースURL | https://llmwebsearch.com/api/v1 |
|---|---|
| 検索 | POST または GET https://llmwebsearch.com/api/v1/search |
| 既にお持ちのURLを読み取る | POST https://llmwebsearch.com/api/v1/extract |
| 残りクレジット | GET https://llmwebsearch.com/api/v1/credits、無料 |
| 認証 | APIキーはAuthorizationヘッダーにBearerトークンとして、またはapi_keyクエリパラメータとして渡してください |
| 課金 | 1クレジットで検索1回分です。最大20件のランク付けされた結果を取得でき、上位3ページは本文抽出されてMarkdownで返されます。4〜10ページを読む場合は2クレジットです。エラーで終わった呼び出しは無料です |
| 当社のページリーダー | LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/)、robots.txt トークン LLMWebSearch |
| 最小パック | $9.25 で 5,000検索、クレジットは無期限 |
APIキーはどうやって取得しますか?
登録フォームはありません。最も時間がかかるのは、チャージのブロックチェーン確認を待つことです。
暗号資産で残高をチャージ
BTC, USDT, USDC, ETH, SOL, LTC で最低 $25 を送金します。サインインはアカウント番号で行います。メールアドレスは任意です。
検索パックを購入
$9.25 で 5,000検索 あれば、1つのエージェントに検索を組み込み、すべてのオプションを試すのに十分です。
APIキーをコピー
暗号資産での入金が確認され、パックが購入されると、APIキーがダッシュボードに用意されています。
LLMWEBSEARCH_API_KEYという環境変数に保存してください。
最初の検索はどのような形ですか?
小さな JSON ボディを付けた HTTPS POST が1回だけです。必須なのは q のみで、人間が入力するように質問やキーワードを指定します。デフォルト設定はほとんどのエージェントに合っています。ランク付けされた5件の結果が返り、上位3件のページは読み取られ、それぞれ最大6,000文字の Markdown として返されます。
以下の3つのスニペットは同じ検索を送信します。ご利用のスタックに合うものを選び、シェルで LLMWEBSEARCH_API_KEY を設定して実行してください。
curl -s "https://llmwebsearch.com/api/v1/search" \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "how to rotate api keys without downtime", "max_results": 5, "read": 3}'import os
import requests
resp = requests.post(
"https://llmwebsearch.com/api/v1/search",
headers={"Authorization": "Bearer " + os.environ["LLMWEBSEARCH_API_KEY"]},
json={"q": "how to rotate api keys without downtime", "max_results": 5, "read": 3},
timeout=60,
)
resp.raise_for_status()
data = resp.json()
print("credits used:", data["credits_used"])
for r in data["results"]:
size = r.get("word_count", 0)
print(r["position"], r["title"], r["url"], r["content_status"], size, "words")
const res = await fetch('https://llmwebsearch.com/api/v1/search', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.LLMWEBSEARCH_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ q: 'how to rotate api keys without downtime', max_results: 5, read: 3 }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);
const first = data.results.find((r) => r.content_status === 'ok');
console.log(first ? `${first.title}\n${first.url}\n\n${first.content.slice(0, 600)}` : 'No page could be read.');
何が返ってきますか?
query、呼び出し時刻(created_at)、価格(credits_used)、そしてランク順の results 配列を含む JSON オブジェクトです。各結果には position、title、url、host、snippet が含まれ、日付が判明している場合は published_at も含まれます。
注目すべきフィールドは content_status です。ok と表示されている場合、ページは読み取られ、その本文抽出が content に、word_count とともに格納されています。read より後の結果は not_requested と表示されます。読み取れなかったページは、例えば blocked_by_robots のように理由を示します。レスポンス形式のページで各フィールドを説明しています。
最も頻繁に変更するパラメータはどれですか?
6つのパラメータでほぼすべてのエージェントに対応できます。すべて任意です。
| パラメータ | 変更内容 |
|---|---|
max_results | 返るランク順の結果数(1〜20) |
read | 上位結果のうち読み取る数(0〜10) |
max_chars | 各ページの本文抽出の長さ上限(500〜50,000文字) |
topic と time_range | Webページの代わりにニュース、および鮮度の期間 |
include_domains | 指定したサイトのみからの結果 |
country と language | 検索を実行する場所と言語 |
検索リファレンスで、それぞれを例付きで、さらに format と exclude_domains も文書化しています。
1回の呼び出しでクレジットはいくつ使いますか?
ほとんどの呼び出しは1クレジットです。ルール全体は次のとおりです:
- 検索で0〜3ページを読み取り: 1クレジット。 これには最大20件のランク順の結果が含まれます。
- 検索で4〜10ページを読み取り: 2クレジット。
- Extract: URLをすでに持っているページを読む場合は、コンテンツ付きで返される3ページごとの開始グループにつき1クレジットで、1回の呼び出しにつき最大20 URLです。拒否されたURLや失敗したURLはカウントされません。
- エラー: 0クレジット。 不正なパラメータ、誤ったキー、残高不足、検索の失敗には料金はかかりません。
- 読み取れなかったページ が成功した検索の中にあっても、その価格は変わりません。
GET https://llmwebsearch.com/api/v1/creditsでの 残高確認 は無料です。
検索クレジットに有効期限はありません。今月使わなかった分は来年も残ります。
サイトが読み取られたくない場合はどうなりますか?
結果はタイトル、URL、スニペットとともに表示されますが、ページ本文は含まれません。当社のリーダーはrobots.txtを尊重します。LLMWebSearchとして名乗り、サイトが自身またはすべてのロボット向けに定めたルールに従い、読み取りを許可されていないページのコンテンツは除外します。robots.txtにContent-Signal: ai-input=noを設定しているサイトは、そのページのコンテンツが結果に含まれません。
サイトが当社のリーダーに拒否を返した場合、その結果には content_status: "target_refused" とサイト自身の HTTP ステータスが target_status に付きます。サイトが当社のリーダーを拒否した場合、結果はコンテンツなしで、サイトのステータスとともに返されます。当社がCAPTCHAを解いたり、アカウントにサインインしたり、ブロックやペイウォールを回避したりすることは一切ありません。エラーページには、すべてのステータスと、リトライする価値のあるものが一覧されています。
次はどこへ進めばよいですか?
- 検索エンドポイント /search のすべてのパラメータを例付きで
- 抽出エンドポイント 既にお持ちの1〜20件のURLを読み取る
- レスポンス形式 各フィールドとすべての content_status
- エラー HTTP エラー、ページのステータス、リトライのルール
- Python requests、async httpx、引用付きの回答
- Node.js fetch、小さなプール、同じ引用ループ
- curl と jq ターミナルのレシピ
- MCPサーバー Claude Code と Claude Desktop 向けの search_web
- LangChainとLlamaIndex ツールとリトリーバー
- OpenAI function calling ツールスキーマ、ループ、Agents SDK
- n8n AI Agent向けのHTTPリクエストツール
- OpenClaw MCP経由での検索
クイックスタート:よくある質問
SDKは必要ですか?
いいえ。LLMWebSearchはプレーンなHTTPS APIなので、どのHTTPクライアントでも動作します。このドキュメントにはPython、Node.js、curl向けのコピー&ペースト可能なコードと、MCP、LangChain、LlamaIndex、OpenAI function calling、n8n、OpenClaw向けのツール定義が記載されています。パッケージは公開していません。
APIは回答を書いてくれますか?
いいえ。APIが返すのは情報源であり、書かれた回答ではありません。あなた自身のモデルがページを読み、返答を書き、URLを引用します。モデル、プロンプト、引用スタイルを自分で選べます。
APIキーをURLに入れられますか?
はい、GET /searchのapi_keyクエリパラメータとして指定できます。Authorizationヘッダーの方が安全です。URLはログやシェル履歴に残るためです。エージェント、アプリ、チームメンバーごとに1つのAPIキーを作成し、ダッシュボードから他のキーに触れずにどれでも失効させられます。
無料で試せるプランはありますか?
いいえ。無料枠はありません。5,000検索パックが試す手段で、最低入金額から購入します。最低入金額に達するためだけに追加した分は、未使用であれば30日以内に依頼によりUSDTまたはUSDCで返金されます。