回答を取得

curl -X POST https://api.tryprofound.com/v2/prompts/answers \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "start_date": "2026-06-18",
    "end_date": "2026-06-19",
    "limit": 10
  }'

{
  "info": {
    "total_results": 27690,
    "count": 10,
    "next_cursor": "Z0FBQUFBQnFQcjNsbDZZaWlzZjR2cXJt...",
    "models": ["ChatGPT", "Google Gemini", "Perplexity", "Claude", "..."],
    "include": [
      "run_id", "date", "model", "topic", "topic_id", "persona", "region",
      "tags", "prompt", "prompt_id", "response", "mentions", "citations",
      "search_queries", "analysis_types", "sentiment_claims"
    ],
    "start_date": "2026-06-18",
    "end_date": "2026-06-19",
    "filter": null
  },
  "data": [
    {
      "run_id": "<uuid>",
      "date": "2026-06-19",
      "model": { "id": "<uuid>", "name": "ChatGPT" },
      "topic": "<string>",
      "topic_id": "<uuid>",
      "region": "United States",
      "persona": null,
      "tags": [],
      "prompt": "<prompt text>",
      "prompt_id": "<uuid>",
      "response": "<full model response text>",
      "mentions": ["Profound", "<string>"],
      "citations": ["https://example.com/article"],
      "search_queries": ["<search query>"],
      "analysis_types": ["visibility"],
      "sentiment_claims": [
        { "asset": "Profound", "theme": "<string>", "claim": "<string>", "sentiment": "positive" }
      ]
    }
    // ...9 more rows (count: 10, total_results: 27690); paginate with next_cursor
  ]
}

POST

prompts

answers

curl -X POST https://api.tryprofound.com/v2/prompts/answers \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "start_date": "2026-06-18",
    "end_date": "2026-06-19",
    "limit": 10
  }'

{
  "info": {
    "total_results": 27690,
    "count": 10,
    "next_cursor": "Z0FBQUFBQnFQcjNsbDZZaWlzZjR2cXJt...",
    "models": ["ChatGPT", "Google Gemini", "Perplexity", "Claude", "..."],
    "include": [
      "run_id", "date", "model", "topic", "topic_id", "persona", "region",
      "tags", "prompt", "prompt_id", "response", "mentions", "citations",
      "search_queries", "analysis_types", "sentiment_claims"
    ],
    "start_date": "2026-06-18",
    "end_date": "2026-06-19",
    "filter": null
  },
  "data": [
    {
      "run_id": "<uuid>",
      "date": "2026-06-19",
      "model": { "id": "<uuid>", "name": "ChatGPT" },
      "topic": "<string>",
      "topic_id": "<uuid>",
      "region": "United States",
      "persona": null,
      "tags": [],
      "prompt": "<prompt text>",
      "prompt_id": "<uuid>",
      "response": "<full model response text>",
      "mentions": ["Profound", "<string>"],
      "citations": ["https://example.com/article"],
      "search_queries": ["<search query>"],
      "analysis_types": ["visibility"],
      "sentiment_claims": [
        { "asset": "Profound", "theme": "<string>", "claim": "<string>", "sentiment": "positive" }
      ]
    }
    // ...9 more rows (count: 10, total_results: 27690); paginate with next_cursor
  ]
}

すべてのレポートの基になる、実行ごとの生データ行です。モデルの回答ごとに 1 行で、その言及、引用、検索クエリを含みます。集計は行われません。

group_by / sort なし: 行は日付の新しい順に並びます。
include で返すフィールド (response、mentions、citations、search_queries、sentiment_claims など) を選択します。省略すると、明示的に指定する必要がある citation_details を除くすべてのフィールドが返されます。
mentions は、回答内でエンティティが登場する順に並んだ、重複のないフラットなリストです。
sentiment_claims は回答から抽出された主張の一覧で、それぞれ asset、theme、claim、sentiment (positive または negative) を含みます。
フィルタ: プロンプトレベルのフィールドに加えて analysis_type (プロンプトレベル: visibility·sentiment·factcheck)、およびトップレベルの domain/page リーフを使用できます。is で 1 つの値、in でリストを指定します (引用 URL の完全一致)。

v2 レポートを初めて使用する場合は、共通のリクエスト形式、フィルタツリー、グループ化、ページネーションについてフィルタリングと概念を参照してください。

ストリーミング (SSE) バリアント (同じボディ、/stream)

POST /v2/prompts/answers/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: {"date": "2026-06-19", "model": {"name": "ChatGPT"}, "prompt": "<prompt text>", "mentions": ["Profound", "<string>"], "citations": ["https://example.com/article"]}

curl -X POST https://api.tryprofound.com/v2/prompts/answers \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "start_date": "2026-06-18",
    "end_date": "2026-06-19",
    "limit": 10
  }'

{
  "info": {
    "total_results": 27690,
    "count": 10,
    "next_cursor": "Z0FBQUFBQnFQcjNsbDZZaWlzZjR2cXJt...",
    "models": ["ChatGPT", "Google Gemini", "Perplexity", "Claude", "..."],
    "include": [
      "run_id", "date", "model", "topic", "topic_id", "persona", "region",
      "tags", "prompt", "prompt_id", "response", "mentions", "citations",
      "search_queries", "analysis_types", "sentiment_claims"
    ],
    "start_date": "2026-06-18",
    "end_date": "2026-06-19",
    "filter": null
  },
  "data": [
    {
      "run_id": "<uuid>",
      "date": "2026-06-19",
      "model": { "id": "<uuid>", "name": "ChatGPT" },
      "topic": "<string>",
      "topic_id": "<uuid>",
      "region": "United States",
      "persona": null,
      "tags": [],
      "prompt": "<prompt text>",
      "prompt_id": "<uuid>",
      "response": "<full model response text>",
      "mentions": ["Profound", "<string>"],
      "citations": ["https://example.com/article"],
      "search_queries": ["<search query>"],
      "analysis_types": ["visibility"],
      "sentiment_claims": [
        { "asset": "Profound", "theme": "<string>", "claim": "<string>", "sentiment": "positive" }
      ]
    }
    // ...9 more rows (count: 10, total_results: 27690); paginate with next_cursor
  ]
}

承認

X-API-Key

string

header

必須

ボディ

application/json

category_id

string<uuid>

必須

start_date

string

必須

YYYY-MM-DD, ET, inclusive

end_date

string

必須

YYYY-MM-DD, ET, inclusive

include

enum<string>[] | null

Which row fields to return: run_id, date, model, topic, topic_id, region, persona, tags, prompt, prompt_id, response, mentions, citations, citation_details, search_queries, analysis_types, sentiment_claims. Omit for all fields except citation_details, which must be requested explicitly because it is expensive.

利用可能なオプション:

run_id,

date,

model,

topic,

topic_id,

persona,

region,

tags,

prompt,

prompt_id,

response,

mentions,

citations,

citation_details,

search_queries,

analysis_types,

sentiment_claims

filter

FilterNode · object | null

and/or/not tree over model, topic, region, persona, prompt, tag, analysis_type (visibility/sentiment/factcheck); plus top-level and leaves domain or page (is one value, or in a list). Substring-search the prompt with {"field": "prompt", "op": "contains", "value": "…"}.

Show child attributes

limit

integer | null

Page size; default 10, max 200.

必須範囲: 0 < x <= 200

max_results

integer | null

Stream endpoint only: cap the number of streamed rows (default: all).

必須範囲: x > 0

cursor

string | null

レスポンス

Successful Response

info

AnswersV2Info · object

必須

Show child attributes

data

AnswerRow · object[]

必須

Show child attributes

はじめに

API リファレンス

インテグレーション

SDK

承認

ボディ

レスポンス