Changelog

​

Added

• POST /v2/reports/sentiment に、source: "citation" によるページ単位の引用センチメントを追加しました。引用の行には、ポジティブセンチメント、ネガティブセンチメント、モデルバランス型の引用シェア、ランクが含まれ、引用シェアまたはポジティブセンチメントで並べ替えることができます。
• 引用センチメント用に、citation_category (is/in) フィルターと、正規化ページ検索(contains_case_insensitive を使用した page)フィルターを追加しました。引用モードはページ単位のみで、カーソルページネーションと /stream SSE バリアントの両方をサポートしますが、group_by はサポートしていません。
• 新しい Prompt Volumes エンドポイント: 1 つのキーワードの週次および月次のボリューム予測を返す Keyword Volume(POST /v2/prompt-volumes/volume/on-the-fly)と、その背後にあるインテントの構成比を返す Keyword Intent Shares(POST /v2/prompt-volumes/intents/on-the-fly)。

​

Added

• 新しいベータ版 YouTube ソーシャルレポート: チャネルのロールアップ、引用された動画のランキング、アトリビューションモードを提供する Query YouTube Channels と Query YouTube Videos。
• 新しいエンドポイント: Get Citation Tags - カテゴリに定義されたカスタム引用タグを、タグごとに { value, name } として返します。これらの値は、下記の新しい citation_tag フィルターに渡すことができます。
• POST /v2/reports/citations に新しい citation_tag フィルターを追加 - 1 つ以上のカスタムタグが付いた URL に引用レポートを絞り込みます(is/in。1 つの in リーフ内の値は OR で結合されます)。

​

Added

• 新しいエンドポイント: Get Citation Categories - カテゴリの引用カテゴリフィルターのオプション。組み込みのバケット(Owned、Competition、Earned Media、Institution、PR Wire、Social、Other)とカスタムカテゴリが含まれます。

​

Added

• 新しいベータ版の /v2/reports エンドポイント — 統一された { info, data } のリクエスト/レスポンス形式で、フィルターに名前または UUID を指定でき、カーソルページネーションと /stream (SSE) バリアントを備えています。
  • POST /v2/reports/visibility - アセットの可視性、シェア・オブ・ボイス、平均順位
  • POST /v2/reports/citations - ドメインおよびページの引用数、シェア、ランク
  • POST /v2/reports/sentiment - ブランドごとのポジティブ/ネガティブセンチメント(比較期間の指定も可能)
  • POST /v2/reports/query-fanouts - プロンプトに回答する際に AI が裏側で生成する検索クエリ
  • POST /v2/reports/factcheck - FactCheck スコア(/stream (SSE) バリアントあり)
  • POST /v2/reports/factcheck/claims - FactCheck の不正確な主張(/stream (SSE) バリアントあり)
• 新しいベータ版エンドポイント: POST /v2/prompts/answers - 実行ごとの Raw 行(言及、引用、検索クエリ)。/stream (SSE) バリアントあり

​

Deprecated

• V1 のレポートエンドポイント(POST /v1/reports/visibility、/citations、/sentiment、/sentiment-v2、/query-fanouts)は、上記の V2 の同等エンドポイントに置き換えるため段階的に廃止されます。引き続き利用可能ですが、削除前に提供終了日をお知らせします。

​

Added

• 新しいエンドポイント: List Agents - 組織で利用可能な Agents を一覧表示します
• 新しいエンドポイント: Get an Agent - Agent とそのスキーマの詳細を取得します
• 新しいエンドポイント: Run an Agent - Agent の新しい実行を開始します
• 新しいエンドポイント: Get an Agent Run - Agent の実行のステータスと結果の詳細を取得します

​

Deprecated

• Agent Analytics の Raw エンドポイントを非推奨にしました。
  • POST /v1/logs/raw - Get Logs
  • POST /v1/logs/raw/bots - Get Bots
• 非推奨化は 2026-04-10 に開始されました
• 2026-04-10 以降に作成された API キーでは、これらのエンドポイントにアクセスできなくなりました
• 2026-04-10 より前に作成された既存の API キーは、提供終了日である 2026-06-10 までこれらのエンドポイントを引き続き使用できます
• 代わりに V2 の集計レポートエンドポイントに移行してください。
  • ボットトラフィックのレポートには POST /v2/reports/bots
  • リファラルトラフィックのレポートには POST /v2/reports/referrals
• 代替エンドポイントの使用例については、Agent Analytics V2 を参照してください

​

Added

• UTC の時間単位でバケット化された時間単位の粒度を持つ新しい /v2/reports エンドポイント(Agent Analytics V2 を参照)
  • POST /v2/reports/bots - 時間単位の解像度のボットトラフィックデータ
  • POST /v2/reports/referrals - 時間単位の解像度のリファラルトラフィックデータ(UTM とリファラーの区別を含む)
• V2 は EST の日単位ではなく UTC の時間単位でバケット化するため、どのタイムゾーンのユーザーでも、クエリを自分のローカルの暦日に合わせられるようになりました

​

Added

• 新しいエンドポイント: Get Referrals Report - 日次集計レポートからリファラルトラフィックデータを取得します
• 新しいエンドポイント: Get Bots Report - 引用、インデックス作成、トレーニング、訪問数の指標を含むボットトラフィック分析を取得します

​

Changed

• サンプルドキュメントの構成を新しい Example Requests タブの下に再編成しました

​

Removed

• 従来のサンプルページ

​

Added

• 新しいエンドポイント: Get Personas - 組織に関連付けられたすべてのペルソナを取得します
• 新しいエンドポイント: Get Category Personas - 指定したカテゴリに関連付けられたすべてのペルソナを取得します
• citations、visibility、sentiment の各レポートに persona ディメンションを追加
• プロンプト回答に persona を追加
• プロンプト回答に model_id を追加
• プロンプト回答に sentiment_themes を追加し、themes を非推奨化。sentiment_themes はテーマとそのセンチメントを返します

​

Changed

• in または not_in フィルター演算子を使用する場合、空でないリスト値が必須になりました
• created_at フィールドは無効化できなくなりました

​

Fixed

• プロンプト回答で重複したプロンプトがエクスポートされないようにしました。

​

Added

• 新しいエンドポイント: Get Category Assets - 特定のカテゴリに関連付けられたアセットを取得します
• 新しいエンドポイント: Get Assets - 組織に関連付けられたすべてのアセットを取得します
• Query Visibility と Query Sentiment に asset_id ディメンションを追加

​

Changed

• hostname、path、root_domain、url をフィルターとして使用する場合、ディメンションとして含めることが必須になりました

​

Fixed

• contains フィルターが正しく適用されない問題
• センチメント指標のフィールド名のタイプミス
  • 修正前: ocurrences
  • 修正後: occurrences
• UUID を含むフィルターが正しく適用されない問題
• start_date および end_date フィルターで、タイムゾーンありとなしの値が混在した場合の処理が正しくない問題