Commerce Productが登場しました
Amazon、Walmart、Sephora、Olive Young、楽天、Zalandoなど17のECサイトの商品ページURLを渡すと、価格、在庫、商品画像と説明画像、仕様、オプションを同じ形で受け取れます。
ChatGPT のタスクで include.entityDetails をオンにすると、回答に出た商品、場所、ブランドのカードごとに ChatGPT が開く詳細パネルの本文、出典、画像を追加料金なしで受け取れます。
得られる結果
CHATGPTのタスクでpayload.include.entityDetails: trueを指定します。- 回答と
followUpsの各回答にentityDetailsが付きます。回答に出たカードごとに1項目で、最大20件です。 - 各項目には
name、category（product、local_business、software、organization、brandなど）、query、status、markdown、sources、products、images、completeが入ります。 sourcesは詳細パネルが引用したサイトの一覧で、position、url、label、site、descriptionを持ちます。
仕組み
ChatGPT の回答で商品、場所、ブランドのカードを押すと、ChatGPT が詳細パネルを開き、読んだサイトを引用しながら対象を短く紹介します。回答が終わると、同じ会話で回答のすべてのカードにこのパネルを要求し、一度に4枚ずつ尋ねます。詳細の取得で回答1件あたり約10秒かかります。
markdown は ChatGPT が書いたパネルそのままで、見出し、リスト、出典リンクが入ります。complete: false は ChatGPT がパネルを最後まで書く前に止まったことを示し、それまでに書かれた本文と出典はそのまま入ります。
カードは1枚ずつ独立して処理されます。失敗したカードは status: "failed" と error（ENTITY_DETAIL_FAILED または ENTITY_DETAIL_EMPTY）を持ち、回答とほかのカードは通常どおり完了します。location、CN、HK を使うタスクのカードは ENTITY_DETAIL_UNAVAILABLE で返ります。
include.entityDetails は CHATGPT で include.html なしで使います。ほかのエンジンに送るか include.html と一緒に送ると、クレジットを確保する前に 422 VALIDATION_ERROR を返します。
活用例
- 買い物中のユーザーが自社商品のカードを押したときに ChatGPT がどう紹介するかを読み、繰り返される仕様、価格、主張を確かめます。
- 自社商品と競合商品ごとに ChatGPT が引用するサイトを確認し、レビューや出店の計画をそのサイトに合わせます。
- 同じ質問を複数の国で尋ね、市場ごとに同じブランドがパネルでどう紹介されるかを比べます。
リクエストを送る
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": "CHATGPT",
"payload": {
"prompt": "What is the best robot vacuum for pet hair?",
"country": "US",
"include": { "entityDetails": true }
}
}'リクエストのフィールド
taskTypestring必須- 実行するエンジン。
CHATGPTやGOOGLEなどを指定します。 payload.promptstring必須- ユーザーがチャットに入力するとおりに書いた質問。最大100,000文字。
payload.countrystring- 質問する市場の2文字の国コード。
US、KR、JPなど。既定値はUS。 payload.include.entityDetailsbooleantrueにすると、回答のカードごとに ChatGPT が開く詳細パネルentityDetailsが加わります。CHATGPTでinclude.htmlなしで使います。既定でオフ、追加クレジットはありません。payload.followUpsarray- 最初の回答のあと、同じChatGPTの会話で続けるターン、最大4個。各項目は質問を送る
{"prompt": "…"}か、直前の回答にあるフォームのボタンを押す{"select": {…}}です。CHATGPTで使えます。 webhook.urlstring- サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。
レスポンス
完了したタスクはこの形で届きます。長さを抑えて抜粋しています。
{
"success": true,
"task": {
"id": "a81e4b26-b4c0-48eb-b20b-10efbd327f1a",
"taskType": "CHATGPT",
"status": "COMPLETED",
"createdAt": "2026-10-21T04:40:09.819Z"
},
"response": {
"text": "For most pet owners, I’d start with the **Dreame L40 Ultra Gen 2**. It offers a strong mix of pet-hair pickup, anti-tangle features, automatic dust emptying, and minimal day-to-day maintenance without necessarily requiring a flagship-level budget. …",
"model": "gpt-6",
"entityDetails": [
"…",
{
"name": "Roborock Saros 20",
"category": "product",
"query": "Roborock Saros 20",
"status": "ok",
"markdown": "The **Roborock Saros 20** is Roborock's 2026 flagship robot vacuum and mop. It focuses on high-end automation with powerful vacuuming, dual spinning mop pads, advanced obstacle avoidance, an ultra-slim body for cleaning under furniture, and a dock that automates most maintenance tasks. …",
"sources": [],
"images": [],
"complete": true
},
{
"name": "MOVA P50 Pro Ultra",
"category": "product",
"query": "MOVA P50 Pro Ultra",
"status": "ok",
"markdown": "## MOVA P50 Pro Ultra\n\nThe **MOVA P50 Pro Ultra** is a premium robot vacuum and mop introduced as MOVA's 2025 flagship model. … ([RTINGS.com +1](https://www.rtings.com/robot-vacuum/reviews/mova/p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com))\n\n### Key features\n\n- **19,000 Pa suction power**\n- **Dual rotating mop pads**\n…",
"sources": [
{
"position": 1,
"url": "https://www.rtings.com/robot-vacuum/reviews/mova/p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com",
"label": "MOVA P50 Pro Ultra Review - RTINGS.com",
"site": "RTINGS.com"
},
{
"position": 2,
"url": "https://us.mova.tech/products/mova-p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com",
"label": "MOVA P50 Pro Ultra Robot Vacuum and Mop Combo | MOVA US",
"site": "MOVA-US"
},
{
"position": 3,
"url": "https://www.idealhome.co.uk/house-manual/floorcare/mova-p50-pro-ultra-robot-vacuum-review?utm_source=chatgpt.com",
"label": "I've spent years telling people that robot mops aren't worth the money - the MOVA P50 Pro Ultra is the first one to change my mind",
"site": "Ideal Home",
"description": "The review provides a detailed assessment of the MOVA P50 Pro Ultra Robot Vacuum, marking a pivotal shift in the author's long-standing skepticism toward robot mops. …"
},
"…"
],
"images": [],
"complete": true
},
"…"
]
}
}task.statusstringQUEUED、PROCESSINGを経て、回答付きのCOMPLETEDかerror付きのFAILEDで終わります。response.textstring- 回答のプレーンテキスト。
response.entityDetailsarray- カードごとに詳細パネルが1つずつ、最大20件入ります。
name、category、query、status（okまたはfailed）、markdown、sources、products、images、completeがあります。失敗したカードにはerrorが付き、回答はそのまま完了します。 response.followUpsarray- 続けたターンごとの回答が、送った順に入ります。各項目には送った
prompt、selectの場合は押したボタンと選んだ値のselection、そしてtext、markdown、sources、searchQueries、modelなど最初の回答と同じフィールドがあります。
結果を受け取る
リクエストすると 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"エラー
VALIDATION_ERRORHTTP 422include.entityDetailsをCHATGPT以外のエンジンに送ったか、include.htmlと一緒に送ったか、boolean 以外の値で送りました。detailsにpayload.include.entityDetailsが入ります。MISSING_API_KEYHTTP 401Authorizationヘッダーが欠けているか、キーが誤っている、期限切れ、または無効化済みです。INSUFFICIENT_CREDITSHTTP 402- 残高がタスクの料金を下回っています。クレジットを追加するかプランを上げてから、もう一度送ってください。
料金
カード詳細は無料です。ChatGPT のタスクは include.entityDetails をオンにしても料金が変わらず、フォローアップの回答を含めて回答1件あたり1クレジットです。
ほかの更新
20のECサイトの商品検索に対応しました
Amazon、Walmart、Coupang、Olive Young、楽天、Flipkart、Zalandoなど5か国20のECサイトで、検索語の商品ランキングを価格、評価、レビュー数とともに同じ形で受け取れます。
最新情報を受け取る
製品の更新をメールでお届けします。