curl -X POST https://api.tryprofound.com/v2/reports/visibility \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"start_date": "2026-06-09",
"end_date": "2026-06-15"
}'
{
"info": {
"total_results": 1,
"count": 1,
"next_cursor": null,
"scope": "owned",
"models": ["ChatGPT", "Google Gemini", "Perplexity", "Claude", "..."],
"start_date": "2026-06-09",
"end_date": "2026-06-15",
"asset_filter": null,
"filter": null
},
"data": [
{
"asset": { "name": "Profound", "owned": true },
"rank": 1,
"visibility_score": 0.48,
"share_of_voice": 0.077,
"average_position": 2.5
}
]
}
レポート v2
可視性
POST
/
v2
/
reports
/
visibility
curl -X POST https://api.tryprofound.com/v2/reports/visibility \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"start_date": "2026-06-09",
"end_date": "2026-06-15"
}'
{
"info": {
"total_results": 1,
"count": 1,
"next_cursor": null,
"scope": "owned",
"models": ["ChatGPT", "Google Gemini", "Perplexity", "Claude", "..."],
"start_date": "2026-06-09",
"end_date": "2026-06-15",
"asset_filter": null,
"filter": null
},
"data": [
{
"asset": { "name": "Profound", "owned": true },
"rank": 1,
"visibility_score": 0.48,
"share_of_voice": 0.077,
"average_position": 2.5
}
]
}
アセットが AI の回答に表示される頻度に加えて、シェア・オブ・ボイスと平均
順位を示します。
assets でアセットを選択し、group_by で結果を分割して、
各指標を行内の名前付きフィールドとして読み取ります。
- 指標:
visibility_score(アセットが表示された回答の割合)、share_of_voice(全言及に占める割合)、average_position(言及されたときの平均順位。低いほど良い)。 group_by:date、model、topic、region、prompt、persona。- アセットの選択 は
assetsパラメータ (名前、リスト、または{ op, value }) で行います。scope: "all"はすべてのアセットをランク付けし、"owned"は自社のアセットのみを返します。 sortでは、リクエストした任意の指標で並べ替えられます。例:{ "field": "visibility_score" }。
v2 レポートを初めて使用する場合は、共通のリクエスト形式、フィルタツリー、グループ化、ページネーションについて フィルタリングと概念 を参照してください。
ストリーミング (SSE) バリアント (同じボディ、/stream)
ストリーミング (SSE) バリアント (同じボディ、/stream)
POST /v2/reports/visibility/stream は 同じリクエストボディ を受け取り、
Server-Sent Events を返します。
まず 1 つの summary イベント (info ブロック) が送信され、続いて行ごとに 1 つの result イベントが送信されます。
limit/cursor は無視され、デフォルトではすべての結果が返されます。上限を設けるには
max_results を指定します。Response (text/event-stream)
event: summary
data: { ...the info block... }
event: result ← one per row, same shape as data[] above
data: {"asset": {"name": "Profound", "owned": true}, "rank": 1, "visibility_score": 0.48}
curl -X POST https://api.tryprofound.com/v2/reports/visibility \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"start_date": "2026-06-09",
"end_date": "2026-06-15"
}'
{
"info": {
"total_results": 1,
"count": 1,
"next_cursor": null,
"scope": "owned",
"models": ["ChatGPT", "Google Gemini", "Perplexity", "Claude", "..."],
"start_date": "2026-06-09",
"end_date": "2026-06-15",
"asset_filter": null,
"filter": null
},
"data": [
{
"asset": { "name": "Profound", "owned": true },
"rank": 1,
"visibility_score": 0.48,
"share_of_voice": 0.077,
"average_position": 2.5
}
]
}
承認
APIKeyHeaderBearerAuth
ボディ
application/json
YYYY-MM-DD, ET, inclusive
YYYY-MM-DD, ET, inclusive
利用可能なオプション:
date, model, topic, region, prompt, persona 利用可能なオプション:
visibility_score, share_of_voice, average_position 利用可能なオプション:
day, week, month 利用可能なオプション:
owned, all A name (is), a list (in), or {op,value} with op is/in/not_in.
A leaf (field/op/value) or an and/or/not group.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Page size; default 10, max 50.
必須範囲:
0 < x <= 50Stream endpoint only: cap the number of streamed rows (default: all).
必須範囲:
x > 0このページは役に立ちましたか？