更新情報改善

回答分析が1クレジットになりました

API
回答分析が2クレジットから1クレジットになったことと、ChatGPT の回答を分析して Northwind を1位、Acme CRM を2位とし、どちらも推奨と判定し、引用サイトを owned と reviews に分けた結果

include.analysis を付けた回答タスクは、以前の半額で、回答に出てくるすべてのブランドの順位、推奨、感情と、引用サイトの種類を返します。

変更点

  • 回答分析は、エンジンの料金にタスクあたり1クレジットが加わります(以前は2クレジット)。分析付きの ChatGPT の回答は合計2クレジットです。
  • 引用サイトの kind が細かくなりました。既知のサイトは editorial、review_media、pr_wire、reviews、commerce、social、blog、community、video、institution に分かれます。それ以外のサイトは brand、content、または上の種類のいずれかに一度分類し、その結果を再利用します。
  • 分析がブランド名そのものと確認した表記(例: Kurly の 컬리)は保存し、次の回答からルールで見つけます。
  • 分析は CHATGPT、GEMINI、PERPLEXITY、GOOGLE、AIMODE、NAVER_AI_BRIEF、NAVER_AI_TAB のタスクで使えます。

仕組み

どの名前がブランドか、そのどれが自社ブランドか、recommended と sentiment はモデルが判定します。位置、順位、名前の照合、出典の種類はルールで計算するため、同じ判定からは同じ結果になります。

自社ブランドと競合は、モニターと同じルールで名前と別名を照合します。ラテン文字は単語単位で、韓国語、日本語、中国語、タイ語はどこでも見つけます。モデルは回答の最初の40,000文字を読み、分析によってタスクの完了が数秒遅くなります。

活用例

  • analysis.targets から、質問全体の言及率、平均順位、シェアをそのまま計算できます。
  • recommended と sentiment で、エンジンごとに自社ブランドと競合がどう語られるかを比べられます。
  • sources[].kind で、自社の分野でエンジンがどんな種類のサイトを引用するか、自社サイトが owned としてどこに出るかを確認できます。

リクエストを送る

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": "best CRM for a small team",
      "country": "US",
      "include": { "analysis": true },
      "brand": "Acme CRM",
      "brandAliases": ["Acme"],
      "brandDomains": ["acme-crm.example"],
      "competitors": [
        "Northwind",
        {
          "name": "Contoso CRM",
          "aliases": ["Contoso"],
          "domains": ["contoso-crm.example"]
        }
      ]
    }
  }'

リクエストのフィールド

taskTypestring必須
実行するエンジン。CHATGPT や GOOGLE などを指定します。
payload.promptstring必須
ユーザーがチャットに入力するとおりに書いた質問。最大100,000文字。
payload.countrystring
質問する市場の2文字の国コード。US、KR、JP など。既定値は US。
payload.include.analysisboolean必須
true にすると analysis が加わります。回答が挙げたすべてのブランドの順位、推奨、感情と、引用サイトの種類です。エンジンの料金に1クレジットが加わります。
payload.brandstring
自社ブランド名。最大200文字で、analysis.targets にロール brand として入ります。
payload.brandAliasesarray
回答が自社ブランドを呼ぶ別名、最大20個。brand と一緒に使います。
payload.brandDomainsarray
自社サイト、最大20個。例: acme-crm.example。そのサイトやサブドメインの引用は kind が owned になります。brand と一緒に使います。
payload.competitorsarray
競合、最大50件。名前だけか、別名とドメインを各20個まで含む { name, aliases, domains } で指定します。analysis.targets にロール competitor として入ります。

レスポンス

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

JSON
{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "…"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "…",
    "analysis": {
      "version": 1,
      "status": "ok",
      "brands": [
        {
          "name": "Northwind",
          "rank": 1,
          "role": "competitor",
          "recommended": true,
          "sentiment": "positive",
          "sentimentScore": 0.9
        },
        {
          "name": "Acme CRM",
          "rank": 2,
          "role": "brand",
          "recommended": true,
          "sentiment": "positive",
          "sentimentScore": 0.5
        },
        {
          "name": "Fabrikam",
          "rank": 3,
          "role": null,
          "recommended": false,
          "sentiment": "neutral",
          "sentimentScore": 0
        }
      ],
      "targets": [
        {
          "name": "Acme CRM",
          "role": "brand",
          "mentioned": true,
          "rank": 2,
          "recommended": true,
          "sentiment": "positive",
          "sentimentScore": 0.5,
          "cited": true
        },
        {
          "name": "Northwind",
          "role": "competitor",
          "mentioned": true,
          "rank": 1,
          "recommended": true,
          "sentiment": "positive",
          "sentimentScore": 0.9,
          "cited": false
        },
        {
          "name": "Contoso CRM",
          "role": "competitor",
          "mentioned": false,
          "rank": null,
          "recommended": null,
          "sentiment": null,
          "sentimentScore": null,
          "cited": false
        }
      ],
      "sources": [
        {
          "position": 1,
          "url": "https://www.acme-crm.example/pricing",
          "domain": "acme-crm.example",
          "kind": "owned",
          "brand": "Acme CRM"
        },
        {
          "position": 2,
          "url": "https://www.g2.com/categories/crm",
          "domain": "g2.com",
          "kind": "reviews",
          "brand": null
        }
      ]
    }
  }
}
response.analysis.statusstring
分析を実行した場合は ok。エンジンが回答テキストなしで終わると no_answer、分析を実行できないと failed です。請求は ok のときだけです。
response.analysis.brandsarray
回答が挙げたすべてのブランドを、最初に挙げた順に並べます。rank は1から始まり、製品はメーカーとして数えます。各ブランドに recommended、sentiment、sentimentScore が付きます。
response.analysis.targetsarray
送ったブランドを送った順に並べます。各ブランドに mentioned、brands 内の rank、そのドメインが引用されたかを示す cited が付きます。
response.analysis.sources[].kindstring
引用サイトの種類。送ったドメインから owned と competitor を決め、それ以外は editorial、review_media、pr_wire、reviews、commerce、social、blog、community、video、institution、brand、content、other のいずれかです。

結果を受け取る

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

料金

タスクは送信時に分析用の1クレジットを確保し、analysis.status が ok のときだけ請求します。no_answer や failed の場合はクレジットを戻し、タスクは回答とともに完了します。プランとクレジット価格は https://querying.ai/pricing に掲載しています。

ほかの更新

最新情報を受け取る

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

RSS フィード