> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Changelog
> Profound REST API の新しいエンドポイント、変更、非推奨、修正
## 概要
この Changelog では、Profound REST API に対するすべての変更、更新、改善を記録しています。新機能、バグ修正、破壊的変更、非推奨、セキュリティ更新を記載し、最新情報の把握とインテグレーションの計画に役立てていただけるようにしています。
V2 は、`/v2/reports/` 配下の Answer Engine Insights および Agent Analytics のレポート(visibility、citations、sentiment、query-fanouts、factcheck、factcheck/claims)と `/v2/prompts/answers` を対象としています。各エンドポイントには、Server-Sent Events (SSE) を返す `/stream` バリアントもあります。
V1 のレポートエンドポイントを含め、V1 のエンドポイントは引き続き利用可能です。API の
バージョニングの詳細については、[Introduction](/ja-jp/rest-api/introduction#api-versioning) を参照してください。
## 変更カテゴリ
変更は次のカテゴリに分類されています。
* **Added** - 新しいエンドポイント、機能、または能力
* **Changed** - 既存のエンドポイントや動作の変更
* **Deprecated** - 将来のバージョンで削除される予定の機能
* **Removed** - 削除された機能
* **Fixed** - バグ修正と訂正
* **Security** - セキュリティの改善と脆弱性へのパッチ
* **Breaking** - 互換性を維持するために対応が必要な変更
### Added
* [`POST /v2/reports/sentiment`](/ja-jp/rest-api/reports/query-sentiment-v2) に、`source: "citation"` によるページ単位の引用センチメントを追加しました。引用の行には、ポジティブセンチメント、ネガティブセンチメント、モデルバランス型の引用シェア、ランクが含まれ、引用シェアまたはポジティブセンチメントで並べ替えることができます。
* 引用センチメント用に、`citation_category` (`is`/`in`) フィルターと、正規化ページ検索(`contains_case_insensitive` を使用した `page`)フィルターを追加しました。引用モードはページ単位のみで、カーソルページネーションと `/stream` SSE バリアントの両方をサポートしますが、`group_by` はサポートしていません。
* 新しい Prompt Volumes エンドポイント: 1 つのキーワードの週次および月次のボリューム予測を返す [Keyword Volume](/ja-jp/rest-api/prompt-volumes/query-volume-v2)(`POST /v2/prompt-volumes/volume/on-the-fly`)と、その背後にあるインテントの構成比を返す [Keyword Intent Shares](/ja-jp/rest-api/prompt-volumes/query-intents-v2)(`POST /v2/prompt-volumes/intents/on-the-fly`)。
### Added
* 新しいベータ版 YouTube ソーシャルレポート: チャネルのロールアップ、引用された動画のランキング、アトリビューションモードを提供する [Query YouTube Channels](/ja-jp/rest-api/reports/query-youtube-channels-v2) と [Query YouTube Videos](/ja-jp/rest-api/reports/query-youtube-videos-v2)。
* 新しいエンドポイント: [Get Citation Tags](/api-reference/organization/get-category-citation-tags) - カテゴリに定義されたカスタム引用タグを、タグごとに `{ value, name }` として返します。これらの値は、下記の新しい `citation_tag` フィルターに渡すことができます。
* [`POST /v2/reports/citations`](/ja-jp/rest-api/reports/query-citations-v2) に新しい `citation_tag` フィルターを追加 - 1 つ以上のカスタムタグが付いた URL に引用レポートを絞り込みます(`is`/`in`。1 つの `in` リーフ内の値は OR で結合されます)。
### Added
* 新しいエンドポイント: [Get Citation Categories](/api-reference/organization/get-category-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](/api-reference/agents/list-agents) - 組織で利用可能な Agents を一覧表示します
* 新しいエンドポイント: [Get an Agent](/api-reference/agents/get-an-agent) - Agent とそのスキーマの詳細を取得します
* 新しいエンドポイント: [Run an Agent](/api-reference/agents/run-an-agent) - Agent の新しい実行を開始します
* 新しいエンドポイント: [Get an Agent Run](/api-reference/agents/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](/ja-jp/rest-api/examples/agent-analytics) を参照してください
### Added
* UTC の時間単位でバケット化された**時間単位の粒度**を持つ新しい `/v2/reports` エンドポイント([Agent Analytics V2](/ja-jp/rest-api/examples/agent-analytics) を参照)
* `POST /v2/reports/bots` - 時間単位の解像度のボットトラフィックデータ
* `POST /v2/reports/referrals` - 時間単位の解像度のリファラルトラフィックデータ(UTM とリファラーの区別を含む)
* V2 は EST の日単位ではなく UTC の時間単位でバケット化するため、どのタイムゾーンのユーザーでも、クエリを自分のローカルの暦日に合わせられるようになりました
### Added
* 新しいエンドポイント: Get [Referrals Report](/api-reference/reports/get-referrals-report-v1) - 日次集計レポートからリファラルトラフィックデータを取得します
* 新しいエンドポイント: Get [Bots Report](/api-reference/reports/get-bots-report-v1) - 引用、インデックス作成、トレーニング、訪問数の指標を含むボットトラフィック分析を取得します
### Changed
* サンプルドキュメントの構成を新しい [Example Requests](/ja-jp/rest-api/examples/example) タブの下に再編成しました
### Removed
* 従来のサンプルページ
### Added
* 新しいエンドポイント: [Get Personas](/api-reference/organization/get-personas) - 組織に関連付けられたすべてのペルソナを取得します
* 新しいエンドポイント: [Get Category Personas](/api-reference/organization/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](/api-reference/organization/get-category-assets) - 特定のカテゴリに関連付けられたアセットを取得します
* 新しいエンドポイント: [Get Assets](/api-reference/organization/get-assets) - 組織に関連付けられたすべてのアセットを取得します
* [Query Visibility](/api-reference/reports/query-visibility) と [Query Sentiment](/api-reference/reports/query-sentiment) に `asset_id` ディメンションを追加
### Changed
* `hostname`、`path`、`root_domain`、`url` をフィルターとして使用する場合、ディメンションとして含めることが必須になりました
### Fixed
* `contains` フィルターが正しく適用されない問題
* センチメント指標のフィールド名のタイプミス
* **修正前:** `ocurrences`
* **修正後:** `occurrences`
* UUID を含むフィルターが正しく適用されない問題
* `start_date` および `end_date` フィルターで、タイムゾーンありとなしの値が混在した場合の処理が正しくない問題