EverySearchディープリサーチAPI

POST

APIの稼働状況

24時間の稼働状況: 正常
24時間の平均応答時間: —

良好／正常
利用可能
制限あり
ほぼ停止

正常

過去24時間

過去30日間

結果ごとにテキストの要約を返す詳細検索。full=trueを指定すると全文も返されます

料金は1,000リクエストあたり$0.69（1回あたり$0.000694）です。失敗した呼び出しと空の結果には課金されません。

AIプロンプト

EveryInfraの「ディープリサーチ」APIを呼び出すスクリプトの作成を手伝ってください。

APIの仕様：
- リクエスト：POST https://api.everyinfra.com/api/v1/search、ヘッダーはAuthorization: Bearer <API Key>。キーは環境変数EVERYINFRA_API_KEYから読み込み、コードには直接書かないでください。
- リクエストボディでは、toolをdeepに設定し、パラメータはparamsに入れてください。
- 必須パラメータ：
  - q: 検索クエリ。
- 任意パラメータ：
  - num: 返す結果の数。
  - full: trueの場合、全文も返されます。
- リクエストボディの例：
{
  "tool": "deep",
  "params": {
    "q": "coffee",
    "num": 3
  }
}
- 課金：料金は1,000リクエストあたり$0.69（1回あたり$0.000694）です。失敗した呼び出しと空の結果には課金されません。
- 422の場合は、エラーに含まれる提案と指定可能な値をもとにパラメータを修正してください。429または503の場合は、Retry-Afterで指定された時間だけ待ってから再試行してください。

コードを書く前に、処理する件数と結果の保存形式を私に確認し、そのうえで、計画と概算費用について私の了承を得てください。

リクエストパラメータ

名前	場所	型	必須	デフォルト	説明
`Authorization`	header	`string`	はい	-	Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
`tool`	body	`string`	はい	`deep`	ツール名です（固定値）。
`q`	body.params	`string`	はい	-	検索クエリ。
`num`	body.params	`integer (1–10)`	いいえ	`5`	返す結果の数。
`full`	body.params	`boolean`	いいえ	`false`	trueの場合、全文も返されます。

コードサンプル

bash

curl -X POST 'https://api.everyinfra.com/api/v1/search' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "tool": "deep",
  "params": {
    "q": "coffee",
    "num": 3
  }
}'

OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。

レスポンス例

実際のレスポンス

October 24, 2026 at 18:28（UTC）に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報（名前、ハンドル、アバター、プロフィールリンク、連絡先）を削除したものです。リストは先頭の2件のみ掲載しています。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。

json

{
  "id": "req_…",
  "tool": "deep",
  "results": [
    {
      "title": "Coffee",
      "url": "https://en.wikipedia.org/wiki/Coffee",
      "snippet": "Coffee is a beverage brewed from roasted, ground coffee beans. Dark-colored and bitter, coffee has a stimulating effect on humans due to its caffeine content; ...",
      "content": "Coffee is a dark-colored, bitter, and stimulating beverage brewed from roasted and ground coffee beans derived from the Coffea plant. It contains caffeine, though decaffeinated options and various substitutes are also available. The production process involves separating seeds fr…"
    },
    {
      "title": "Coffee - The Nutrition Source",
      "url": "https://nutritionsource.hsph.harvard.edu/food-features/coffee/",
      "snippet": "Various polyphenols in coffee have been shown to prevent cancer cell growth in animal studies. Coffee has also been associated with decreased estrogen levels, a ...",
      "content": "Coffee has a long history of debate regarding its health benefits and risks, having transitioned from being listed as a possible carcinogen by the WHO in 1991 to being exonerated by 2016. Research indicates that moderate consumption of 3 to 5 cups per day is generally considered …"
    }
  ],
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

エラーと課金

401: キーが未指定か無効です。
402: 残高が不足しています。先にチャージしてください。
422: パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
429: 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
503: 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
200（空）: データがありません。課金はされません。

エラー