ChatGPTに対応しました

選んだ市場からChatGPTに質問し、その市場の実際の訪問者が見る回答を、すべての引用元とともにJSONで受け取れます。

得られる結果

• textとmarkdown: 回答の全文を、プレーンテキストと書式付きの両方で受け取れます。
• sources: 回答が引用したすべてのページを、URLとタイトル付きで順番どおりに受け取れます。
• searchQueries: ChatGPTが回答中に実行したWeb検索です。質問をどう調べたかがわかります。
• model: そのセッションで回答したモデルです。

仕組み

タスクごとに指定した国で新しいChatGPTセッションを開き、質問を書かれたとおりに尋ねます。その市場の初回訪問者が受け取る回答が返るため、推薦されるブランドや引用されるページは顧客が実際に読む内容と一致します。

実行のたびに新しい観測になります。同じ質問を定期的に繰り返して結果を比べれば、回答、推薦ブランド、引用ページの変化を時系列で追えます。

活用例

• 購入者が尋ねる質問で、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": "Search the web and recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with source links. Keep the answer under 180 words.",
      "country": "US"
    }
  }'

リクエストのフィールド

taskTypestring必須

実行するエンジン。CHATGPT や GOOGLE などを指定します。

payload.promptstring必須

ユーザーがチャットに入力するとおりに書いた質問。最大100,000文字。

payload.countrystring

質問する市場の2文字の国コード。US、KR、JP など。既定値は US。

payload.locationstring

country 内の場所。駅、地区、住所など最大200文字。エンジンはその場所にいるユーザーへの回答を返します。CHATGPT、GEMINI、GOOGLE、AIMODE、GOOGLE_SERP で使えます。

payload.include.markdownboolean

見出し、リスト、表、リンクを保った markdown を返します。既定でオンです。

payload.include.searchQueriesboolean

ChatGPT が回答のために実行したウェブ検索 searchQueries を返します。既定でオンです。

payload.include.shoppingboolean

ChatGPT が表示する商品カードを shoppingCards として返します。既定でオンです。

payload.include.rawResponseboolean

true にすると、構造化された結果と並べてエンジンの生の出力を受け取り、独自に解析できます。既定はオフ。

webhook.urlstring

サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。

idempotencyKeystring

リクエストに付ける独自の ID。1つのキーはアカウント内で1つのタスクを作るため、再送してもタスクは1つのままです。

レスポンス

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

{
  "success": true,
  "task": {
    "id": "8bafb0ff-3cc7-4bc4-99bf-32dbacaf7736",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:15.604Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "For commuting, I’d prioritize strong ANC (trains, buses, traffic) and 6+ hours of playback. These three are top picks:",
    "markdown": "| Earbuds | Noise cancellation | Battery life (ANC on) |\n|---|---|---|\n| Bose QuietComfort Ultra Earbuds (2nd Gen) | Excellent — among the strongest ANC available | ~6 hrs (24 hrs with case) … |\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://www.wired.com/gallery/best-noise-canceling-earbuds/",
        "label": "Best Noise-Canceling Earbuds: Bose, Sony, Apple, and More | WIRED",
        "attribution": "WIRED",
        "datePublished": "March 29, 2026"
      },
      {
        "position": 2,
        "url": "https://www.tomsguide.com/audio/earbuds/best-noise-canceling-earbuds",
        "label": "Best noise-canceling earbuds in 2026: Tested and reviewed | Tom's Guide",
        "attribution": "Tom's Guide",
        "datePublished": "July 24, 2026"
      }
    ],
    "searchQueries": [
      "best wireless earbuds commuting noise cancellation battery life Sony Bose Apple"
    ]
  }
}

task.statusstring

QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。

credits.creditsChargedinteger

完了したタスクに請求されたクレジット。失敗したタスクは0です。

response.textstring

回答のプレーンテキスト。

response.markdownstring

書式を保った回答。見出し、リスト、表、リンクがそのまま入ります。

response.sourcesarray

回答が引用したページ。エンジンの表示順に position、url、label が入ります。

response.searchQueriesarray

エンジンが回答を書くために実行したウェブ検索。

response.shoppingCardsarray

回答とともに表示された商品カード。商品名、価格、販売店、評価、商品リンク。

結果を受け取る

リクエストすると 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"

料金

完了したChatGPTタスク1件につき2クレジットを使用します。