本文へスキップ
更新情報新機能

Searchを紹介します

Search
POST /v1/search に送った「寒冷地でヒートポンプはどう動くか」の検索。サイトのロゴとスコアが付いた3ページ、答えになる部分を強調した最初のページの段落、FRAMES の正答率 Pro Search 68.5% と Search 66.5%

エージェントにウェブ検索を1回の呼び出しで加えられます。各結果にクエリに答えるページの段落が付き、1検索0.5クレジットです。

得られる結果

  • results: クエリに合うページをスコア順に最大10件。各結果に url、title、snippet、0〜1の関連度 score があります。
  • text: 各ページでクエリに答える段落。1件あたり最大10,000文字で、そのままモデルに渡せます。
  • ページが示していれば publishedDate と siteName も届きます。
  • querying.ai MCP サーバーの web_search ツールでも同じ料金で使えます。Claude Code、Codex、Cursor などの MCP クライアントに対応します。

仕組み

POST /v1/search にクエリを送ると、結果が同じレスポンスで返るまでリクエストが開いたままになります。エージェントは1回のリクエストで文脈を得られ、ページを取りに行く2回目の呼び出しは要りません。

type で検索方式を選びます。既定値は standard です。pro はウェブをより広く探し、複数の情報源が必要な質問に合う段落をより丁寧に選んで、約4秒で答えます。どちらも site:、-site:、after:、before: 演算子で範囲を絞れます。30秒を過ぎても終わらない検索はタスクとして返り、結果は GET /v1/async/task/{id} で読み取ります。

2026年11月15日に FRAMES の質問200問で測ったところ、モデルが Search の結果だけで答えた正答率は66.5%、Pro Search の結果では68.5%でした。測定方法と全体の比較は Search のページにあります: https://querying.ai/agent-search

FRAMES の正答率と1,000検索あたりの価格: querying.ai Search 66.5%・$0.50、Pro Search 68.5%・$2.00、Parallel fast 63.5%・$1.00、Parallel advanced 70.0%・$5.00、Exa 68.0%・$7.00、Tavily basic 48.5%・$5.00、Tavily advanced 53.5%・$10.00、Firecrawl 43.5%・$1.20
企業ニュースの質問100問で正答1,000件を得る費用: querying.ai Search $0.51、Parallel fast $1.00、Firecrawl $1.26、querying.ai Pro Search $2.02、Parallel advanced $5.00、Tavily basic $5.10、Exa $7.07、Tavily advanced $10.20

活用例

  • コーディングやリサーチのエージェントに、ページ本文まで付いたウェブ検索を1回のツール呼び出しで渡します。
  • チャットボットの回答を最新のページに基づかせ、段落ごとの url を出典として示します。
  • includeDomains で信頼できるサイトの中だけ、after: で最近のページだけを探します。

リクエストを送る

API キーを Authorization ヘッダーに入れてリクエストを送ります。

curl -X POST https://api.querying.ai/v1/search \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "how do heat pumps work in cold climates",
    "type": "pro",
    "numResults": 3,
    "contents": { "text": { "maxCharacters": 500 } }
  }'

リクエストのフィールド

querystring必須
検索クエリ。最大400文字。site:example.com、-site:example.com、after:YYYY-MM-DD、before:YYYY-MM-DD 演算子を使えます。
typestring
standard または pro。pro は複数の情報源が必要な質問をより深く検索します。既定値は standard。
numResultsinteger
返す結果の数。1〜10、既定値は5。
contents.text.maxCharactersinteger
各結果の text に入れるページ本文の文字数。200〜10,000、既定値は2,000。
userLocationstring
1つの市場の結果が必要なときに指定する2文字の国コード。省略するとクエリの言語で最も速く検索します。
includeDomainsarray
ホスト名を最大20個。これらのサイトとサブドメインの結果だけを返します。
excludeDomainsarray
結果から外すホスト名を最大20個。
idempotencyKeystring
リクエストに付ける独自の ID。1つのキーはアカウント内で1つのタスクを作るため、再送してもタスクは1つのままです。

レスポンス

レスポンスです。長さを抑えて抜粋しています。

JSON
{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "SEARCH",
    "status": "COMPLETED",
    "createdAt": "…",
    "latencyMs": 4063
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "query": "how do heat pumps work in cold climates",
    "source": "all",
    "type": "pro",
    "results": [
      {
        "url": "https://www.carrier.com/us/en/residential/hvac-resources/heat-pumps/cold-climate-heat-pump/",
        "title": "Cold Climate Heat Pump Systems | Efficient Heating in Extreme …",
        "snippet": "In the winter, heat pumps work in cold weather by extracting thermal energy from the outdoor air and transferring it …",
        "text": "## Do cold climate heat pumps work?\n\nA heat pump is a versatile, year-round system that heats and cools your home by moving heat energy rather than generating it. In the winter, heat pumps work in cold weather by extracting thermal energy from the outdoor air and transferring it indoors.\n\n…",
        "score": 1,
        "publishedDate": "2026-09-15T11:03:00.000Z"
      },
      {
        "url": "https://www.mitsubishicomfort.com/articles/mythbusters-heat-pumps-for-extreme-cold-climates",
        "title": "Heat Pumps in Extreme Cold Climates | Mitsubishi Electric HVAC US",
        "snippet": "In cold climates, heat pumps typically experience a decrease in pressure, refrigerant flow rate and operational …",
        "text": "## Myth: Heat Pumps Are Only for Mild and Warm Climates\n\nHow do they work? In cold climates, heat pumps typically experience a decrease in pressure, refrigerant flow rate and operational capacity. …",
        "score": 0.8333,
        "publishedDate": "2026-10-19T12:06:06.108Z"
      },
      {
        "url": "https://homes.rewiringamerica.org/articles/heating-and-cooling/heat-pumps-cold-weather",
        "title": "Do heat pumps work in cold climates? - Rewiring America",
        "snippet": "…",
        "text": "In heating mode, heat pumps go into reverse and pump heat from the air outside your home to the inside. …",
        "score": 0.6667
      }
    ]
  }
}
task.statusstring
QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。
credits.creditsChargedinteger
完了したタスクに請求されたクレジット。失敗したタスクは0です。
response.resultsarray
スコア順のページ。各結果に url、title、snippet、text、score があり、ページが示していれば publishedDate と siteName も付きます。
response.results[].textstring
ページの中でクエリに答える段落。ページ順で、見出しは # 行、リストは - 行で入ります。
response.results[].scorenumber
0〜1の関連度。同じレスポンスの中で比較します。

料金

クレジットは検索の完了時に差し引かれます。standard の検索は0.5クレジット、pro の検索は2クレジットです。Max プランでは standard の検索1,000回が$0.50です。新しいアカウントは無料の500クレジットから始まり、standard の検索1,000回分にあたります。プランは https://querying.ai/pricing に掲載しています。

ほかの更新

最新情報を受け取る

製品の更新をメールでお届けします。

RSS フィード