更新情報新機能

Perplexityが回答のために行った検索がわかります

Perplexity
ワイヤレスイヤホンについての Perplexity の回答と、出典を含む JSON の結果

自分の市場でPerplexityに質問し、番号付きの出典、実行された検索、提案されるフォローアップ質問まで回答と一緒に受け取れます。

得られる結果

  • textとmarkdown: 回答の全文を、プレーンテキストと書式付きで受け取れます。
  • sources: 回答の根拠となった番号付きの出典です。それぞれにURL、タイトル、短い説明が付きます。
  • related_queries: Perplexityが次に提案するフォローアップ質問です。
  • 回答に画像、動画、場所、ホテル、商品カードが表示されると、それらも受け取れます。

仕組み

Perplexityはすべての質問にWeb検索で答え、番号付きの出典で各文の根拠を正確に示します。タスクごとに指定した国から質問し、その市場の人が見るとおりの回答と出典を返します。

include.searchQueriesを有効にすると、Perplexityが実行した検索も受け取れます。質問をどんな調査ステップに分けたかがわかります。

活用例

  • 自社カテゴリーでPerplexityが頼るドメインと、出典の中での自社ページの位置を確認できます。
  • 提案されたフォローアップ質問を、追跡する新しい質問として活用できます。
  • 同じ質問でのPerplexityの推薦をChatGPTやGeminiと比較できます。

リクエストを送る

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": "Recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with sources. Keep it under 180 words.",
      "country": "US",
      "include": { "markdown": true }
    }
  }'

リクエストのフィールド

taskTypestring必須
実行するエンジン。CHATGPT や GOOGLE などを指定します。
payload.promptstring必須
ユーザーがチャットに入力するとおりに書いた質問。最大100,000文字。
payload.countrystring
質問する市場の2文字の国コード。US、KR、JP など。既定値は US。
payload.include.markdownboolean
true にすると、見出し、リスト、表、リンクを保った markdown が加わります。
payload.include.searchQueriesboolean
true にすると、エンジンが回答のために実行したウェブ検索 searchQueries が加わります。
webhook.urlstring
サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。
idempotencyKeystring
リクエストに付ける独自の ID。1つのキーはアカウント内で1つのタスクを作るため、再送してもタスクは1つのままです。

レスポンス

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

JSON
{
  "success": true,
  "task": {
    "id": "67030796-8ecd-4aed-b2c4-6ced6639a313",
    "taskType": "PERPLEXITY",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:24.023Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "text": "For commuting, I’d choose **Sony for strongest all-around isolation**, **Bose for maximum ANC comfort**, or **AirPods for Apple integration**.",
    "markdown": "| Earbuds | Noise cancellation | Battery life* | Best for |\n|---|---|---:|---|\n| **Sony WF-1000XM5** | Excellent; measured 32 dB attenuation in key transit-noise frequencies | 8h / 24h case | Android and mixed devices |\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://www.rtings.com/headphones/reviews/best/wireless-earbuds",
        "label": "The 6 Best Wireless Earbuds of 2026 - RTINGS.com",
        "description": "The best wireless earbuds we've tested are the Sony WF-1000XM6. These buds offer top-tier ANC performance."
      },
      {
        "position": 2,
        "url": "https://www.businessinsider.com/guides/tech/best-earbuds",
        "label": "The best earbuds of 2026, tested by audio experts - Business Insider",
        "description": "The best wireless earbuds offer great audio quality in a compact design. These are our top picks from Sony, Bose, Technics, Anker, Apple, and JLab."
      }
    ]
  }
}
task.statusstring
QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。
credits.creditsChargedinteger
完了したタスクに請求されたクレジット。失敗したタスクは0です。
response.textstring
回答のプレーンテキスト。
response.markdownstring
書式を保った回答。見出し、リスト、表、リンクがそのまま入ります。
response.sourcesarray
回答が引用したページ。エンジンの表示順に position、url、label が入ります。
response.searchQueriesarray
エンジンが回答を書くために実行したウェブ検索。

結果を受け取る

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

料金

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

ほかの更新

最新情報を受け取る

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

RSS フィード