更新情報2026年10月19日新機能

AI エンジンが回答と一緒に表示した画面を受け取れます

API

同じ CRM の質問で Perplexity と ChatGPT が表示した画面を保存したページと、include.html で画面を返す6つのエンジンのロゴ

ChatGPT、Gemini、Perplexity、Meta AI、Google AI Overviews、AI Mode のタスクで include.html をオンにすると、エンジンが実際に表示した回答画面を、API キーなしで開けるページのリンクで受け取れます。

得られる結果

CHATGPT、GEMINI、PERPLEXITY、META_AI、GOOGLE、AIMODE で payload.include.html: true を指定します。
レスポンスの html：status（ok または failed）、url、expiresAt。リンクはタスク完了から30日間開けます。
ページは API キーなしで開き、外部から何も読み込まないため、リンクで共有したりレポートに埋め込んだりできます。
回答のフィールド（text、sources など）はこれまでどおり届きます。画面の保存に失敗してもタスクは失敗しません。

仕組み

ChatGPT、Gemini、Perplexity、Meta AI では、実際のブラウザでエンジンのサイトに質問し、回答が終わった時点の画面（サイドバー、質問、出典チップ付きの回答、入力欄）を保存します。回答のフィールドも同じ質問から作られ、回答と一致しない画面は保存しません。

保存前にスクリプトを取り除き、画像、スタイル、フォントをファイル内に入れます。そのため、どのブラウザでもエンジンから何も読み込まずに同じ画面で開きます。

Google AI Overviews と AI Mode では、そのタスクで Google が返した結果ページをスクリプトだけ除いて保存します。AI Overview の本文と出典リストは「もっと見る」と「すべて表示」を押した状態で保存するため、スクリプトなしでも回答全体が読めます。

画面を取得または保存できなかった場合、html は { "status": "failed", "error": "EVIDENCE_FAILED" } となり、タスクは回答とともに完了します。location、CN、HK、continueFrom を使う ChatGPT タスクと、location、CN、DE、GB、IR を使う Gemini タスクは、常に画面なしで返ります。

活用例

クライアント向けレポートの数値の横にエンジンの画面を添え、ユーザーが見たとおりの回答を示します。
解析結果がおかしく見えるときにページを開き、ブランドや出典が画面のどこにあったかを確かめます。
各エンジンがその日どう答えたかを日付つきの記録として残します。ページは30日間保存されるので、長く残したいものはダウンロードしてください。

リクエストを送る

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

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "PERPLEXITY",
    "payload": {
      "prompt": "What are the best CRM tools for a 10-person startup?",
      "country": "US",
      "include": { "html": true }
    }
  }'

リクエストのフィールド

taskTypestring必須: 実行するエンジン。CHATGPT や GOOGLE などを指定します。
payload.promptstring必須: ユーザーがチャットに入力するとおりに書いた質問。最大100,000文字。
payload.countrystring: 質問する市場の2文字の国コード。US、KR、JP など。既定値は US。
payload.include.htmlboolean: true にすると、エンジンが回答と一緒に表示した画面へのリンク html が加わります。CHATGPT、GEMINI、PERPLEXITY、META_AI、GOOGLE、AIMODE で使えます。既定でオフです。
webhook.urlstring: サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。

レスポンス

完了したタスクはこの形で届きます。長さを抑えて抜粋しています。

JSON

{
  "success": true,
  "task": {
    "id": "7be8662e-5f62-48bf-a54a-7b58a2701b7c",
    "taskType": "PERPLEXITY",
    "status": "COMPLETED",
    "createdAt": "2026-10-21T01:20:07.445Z"
  },
  "credits": { "creditsToCharge": 1.25, "creditsCharged": 1.25 },
  "response": {
    "text": "For a 10-person startup, the strongest shortlist is **HubSpot** for a free, easy starting point; **Pipedrive** for a straightforward sales pipeline; **Zoho CRM** for budget-friendly customization; and **Attio** for a flexible, data-driven CRM.[1][2][3]\n\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://slack.com/blog/crm/best-crms-for-startups",
        "label": "Best CRMs for Startups: Tools, Benefits, and Tips"
      },
      {
        "position": 2,
        "url": "https://attio.com/f/best-crm-for-startups",
        "label": "Best CRMs for startups in 2026"
      }
    ],
    "html": {
      "status": "ok",
      "url": "https://api.querying.ai/v1/evidence/1792545851-e8cc8a32dd7f456eb807a0e09e9bc0fa.html",
      "expiresAt": "2026-11-20T01:24:11.000Z"
    }
  }
}

task.statusstring: QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。
credits.creditsChargedinteger: 完了したタスクに請求されたクレジット。失敗したタスクは0です。
response.textstring: 回答のプレーンテキスト。
response.sourcesarray: 回答が引用したページ。エンジンの表示順に position、url、label が入ります。
response.htmlobject: エンジンの画面です。status（ok または failed）、API キーなしで開ける url、タスク完了から30日後の expiresAt が入ります。保存できなかった場合は error が EVIDENCE_FAILED になり、タスクは回答とともに完了します。

結果を受け取る

リクエストすると status が QUEUED のタスクがすぐに返ります。status が COMPLETED か FAILED になるまで GET /v1/async/task/{id} で取得するか、webhook.url を指定して同じ task、credits、response をサーバーで受け取ります。結果はタスクの完了から24時間取得できます。

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

エラー

EVIDENCE_UNSUPPORTEDHTTP 422: 画面を返せないエンジンで include.html をオンにしました。画面を返すのは CHATGPT、GEMINI、PERPLEXITY、META_AI、GOOGLE、AIMODE だけです。
VALIDATION_ERRORHTTP 400: フィールドが欠けているか、範囲外の値です。details に該当するフィールドが入ります。
MISSING_API_KEYHTTP 401: Authorization ヘッダーが欠けているか、キーが誤っている、期限切れ、または無効化済みです。
INSUFFICIENT_CREDITSHTTP 402: 残高がタスクの料金を下回っています。クレジットを追加するかプランを上げてから、もう一度送ってください。

料金

ChatGPT、Perplexity、Meta AI では、エンジンの料金に0.25クレジットが加わります。この0.25クレジットは送信時に確保し、html.status が ok のときだけ差し引きます。Gemini、Google AI Overviews、AI Mode では画面は無料です。画面をオンにすると6つのエンジンすべてでタスク1件が1.25クレジットになり、例の Perplexity タスクも1.25クレジットでした。

ほかの更新

API2026年10月22日新機能
Commerce Productが登場しました
Amazon、Walmart、Sephora、Olive Young、楽天、Zalandoなど17のECサイトの商品ページURLを渡すと、価格、在庫、商品画像と説明画像、仕様、オプションを同じ形で受け取れます。
API2026年10月21日新機能
20のECサイトの商品検索に対応しました
Amazon、Walmart、Coupang、Olive Young、楽天、Flipkart、Zalandoなど5か国20のECサイトで、検索語の商品ランキングを価格、評価、レビュー数とともに同じ形で受け取れます。

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

RSS フィード