> ## 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.

# Agent Analytics

> Agent Analytics エンドポイントのサンプルリクエスト。

このガイドでは、一般的な API リクエストの実践的な例を紹介します。すべての例で JSON 形式を使用し、API キーによる認証が必要です。

# レポート

<Tabs>
  <Tab title="日次レポート (V1)">
    **V1** レポートエンドポイント(`/v1/reports/*`)の例です。EST に基づく日次の事前集計データを扱います。
    時間単位の粒度が必要な場合は、上部の **時間単位レポート (V2)** タブを使用してください。

    <Info>
      Agent Analytics の Raw ログエンドポイントは廃止されました。実行ごとの Raw の
      プロンプト回答行には、`POST /v2/prompts/answers` を使用してください。ボットおよびリファラル
      トラフィックには、集計済みの `/v2/reports/bots` および `/v2/reports/referrals`
      エンドポイントを使用してください。
    </Info>

    * **容量:** 集計レポートエンドポイントを使用して、日付範囲全体を 1 回のリクエストで取得できます。
    * **粒度:** データは日単位でバケット化されます。タイムスタンプは EST における各日の開始時刻に正規化されます。

    ## ボットレポート

    <Tabs>
      <Tab title="ボットのハイライト">
        ボットの種類別に訪問数を取得します。

        <img src="https://mintcdn.com/profound-37face47/_84snNj2y4O4wlvX/images/rest-api/aa-examples/get-bot-visit-highlights.png?fit=max&auto=format&n=_84snNj2y4O4wlvX&q=85&s=f61cba46eb807a2712365c4ad71b8e1e" alt="Dashboard Metrics" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-bot-visit-highlights.png" />

        ```http theme={null}
        POST /v1/reports/bots HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-12",
          "end_date": "2025-12-18",
          "metrics": ["citations", "training", "indexing"]
        }
        ```

        ```json theme={null}
        {
          "info": {},  // removed for brevity
          "data": [
            {
              "metrics": [
                20640,
                8450,
                3646
              ],
              "dimensions": []
            }
          ]
        }
        ```
      </Tab>

      <Tab title="日別の引用">
        ChatGPT の引用数を日別に取得します。

        <img src="https://mintcdn.com/profound-37face47/_84snNj2y4O4wlvX/images/rest-api/aa-examples/get-citations-by-bot-by-day.png?fit=max&auto=format&n=_84snNj2y4O4wlvX&q=85&s=42042eb802d987cc0f20ede22bedfe1a" alt="By Day Breakdown" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-citations-by-bot-by-day.png" />

        <Tip>
          次のように置き換えることで、ボット別に分類された日次の完全なリストを簡単に取得できます。

          ```
          "dimensions": ["date", "bot_name"],
          "filters": [],
          ```
        </Tip>

        ```http theme={null}
        POST /v1/reports/bots HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-12",
          "end_date": "2025-12-18",
          "dimensions": ["date"],
          "filters": [
              {"field": "bot_name", "operator": "is", "value": "ChatGPT-User"}
          ],
          "order_by": {
              "date": "desc"
          },
          "metrics": ["citations"]
        }
        ```

        ```json theme={null}
        {
            "info": {},  // removed for brevity
            "data": [
                {
                    "metrics": [
                        2698
                    ],
                    "dimensions": [
                        "2025-12-18"
                    ]
                },
                {
                    "metrics": [
                        2847
                    ],
                    "dimensions": [
                        "2025-12-17"
                    ]
                },
                {
                    "metrics": [
                        2986
                    ],
                    "dimensions": [
                        "2025-12-16"
                    ]
                },
                {
                    "metrics": [
                        3029
                    ],
                    "dimensions": [
                        "2025-12-15"
                    ]
                },
                {
                    "metrics": [
                        2075
                    ],
                    "dimensions": [
                        "2025-12-14"
                    ]
                },
                {
                    "metrics": [
                        1881
                    ],
                    "dimensions": [
                        "2025-12-13"
                    ]
                },
                {
                    "metrics": [
                        2717
                    ],
                    "dimensions": [
                        "2025-12-12"
                    ]
                }
            ]
        }
        ```
      </Tab>

      <Tab title="プロバイダー別のページ訪問">
        プロバイダーに絞り込んで、ボットの種類別にページ訪問数を取得します。

        <Info>
          右上の **Platforms** で OpenAI が選択されていることに注目してください。
        </Info>

        <img src="https://mintcdn.com/profound-37face47/_84snNj2y4O4wlvX/images/rest-api/aa-examples/get-page-visits-by-provider.png?fit=max&auto=format&n=_84snNj2y4O4wlvX&q=85&s=2234a9d846acd32bf2379d7ceca88089" alt="Page Visits by Provider" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-page-visits-by-provider.png" />

        <Tip>
          フィルターを削除すると、すべてのプロバイダーの指標を確認できます。
        </Tip>

        ```http theme={null}
        POST /v1/reports/bots HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-12",
          "end_date": "2025-12-18",
          "dimensions": ["path"],
          "filters": [
              {"field": "bot_provider", "operator": "is", "value": "openai"}
          ],
          "order_by": {"citations": "desc"},
          "metrics": ["citations", "indexing", "training"],
          "pagination": {
              "limit": 10,
              "offset": 0
          }
        }
        ```

        ```json theme={null}
        {
          "info": {},  // removed for brevity
          "data": [
              {
                "metrics": [
                  1255,
                  1614,
                  38
                ],
                "dimensions": [
                  "/"
                ]
              },
              {
                "metrics": [
                  643,
                  5,
                  1
                ],
                "dimensions": [
                  "/guides/generative-engine-optimization-geo-guide-2025"
                ]
              },
              {
                "metrics": [
                  603,
                  18,
                  3
                ],
                "dimensions": [
                  "/blog/now-tracking-gpt-5-2-in-chatgpt"
                ]
              },
              {
                "metrics": [
                  584,
                  7,
                  3
                ],
                "dimensions": [
                  "/blog/ai-platform-citation-patterns"
                ]
              },
              {
                "metrics": [
                  445,
                  1,
                  0
                ],
                "dimensions": [
                  "/blog/best-generative-engine-optimization-tools"
                ]
              },
              {
                "metrics": [
                  396,
                  14,
                  1
                ],
                "dimensions": [
                  "/profound-index"
                ]
              },
              {
              "metrics": [
                  385,
                  6,
                  1
              ],
              "dimensions": [
                  "/guides/what-is-answer-engine-optimization"
              ]
              },
              {
                "metrics": [
                  376,
                  2,
                  0
                ],
                "dimensions": [
                  "/blog/semrush-ai-visibility-toolkit-review"
                ]
              },
              {
                "metrics": [
                  372,
                  5,
                  2
                ],
                "dimensions": [
                  "/blog/understanding-grok-a-comprehensive-guide-to-grok-websearch-grok-deepsearch"
                ]
              },
              {
                "metrics": [
                  371,
                  7,
                  1
                ],
                "dimensions": [
                  "/blog/choosing-ai-visibility-provider"
                ]
              }
          ]
        }
        ```
      </Tab>
    </Tabs>

    ## リファラルレポート

    <Tabs>
      <Tab title="プラットフォーム別のリファラル">
        プラットフォーム別にリファラル数を取得します。

        <Info>
          注:

          `other` は、LinkedIn や Facebook などの**従来のソース**からのリファラルを表します。

          `internal` は、ブログ記事から別のブログ記事へのリンクなど、自社 Web サイト内からのリファラルを表します。
        </Info>

        <img src="https://mintcdn.com/profound-37face47/_84snNj2y4O4wlvX/images/rest-api/aa-examples/get-referrals-by-platform.png?fit=max&auto=format&n=_84snNj2y4O4wlvX&q=85&s=d4ef5e6ecb21e0f05cd03cbcc07fa22b" alt="Referrals By Platform" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-referrals-by-platform.png" />

        ```http theme={null}
        POST /v1/reports/referrals HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-12",
          "end_date": "2025-12-18",
          "dimensions": ["referral_source"],
          "filters": [
            {"field": "referral_source", "operator": "not_in", "value": ["none", "internal"]}
          ],
          "metrics": ["visits"]
        }
        ```

        ```json theme={null}
        {
          "info": {},  // removed for brevity
          "data": [
            {
              "metrics": [
                222022
              ],
              "dimensions": [
                "other"
              ]
            },
            {
              "metrics": [
                5171
              ],
              "dimensions": [
                "openai"
              ]
            },
            {
              "metrics": [
                102
              ],
              "dimensions": [
                "perplexity"
              ]
            },
            {
              "metrics": [
                39
              ],
              "dimensions": [
                "gemini"
              ]
            },
            {
              "metrics": [
                22
              ],
              "dimensions": [
                "anthropic"
              ]
            },
            {
              "metrics": [
                2
              ],
              "dimensions": [
                "deepseek"
              ]
            }
          ]
        }
        ```
      </Tab>

      <Tab title="日別のボットリファラル">
        AI ボットからのリファラル数を日別に取得します。

        <img src="https://mintcdn.com/profound-37face47/_84snNj2y4O4wlvX/images/rest-api/aa-examples/get-referrals-by-day.png?fit=max&auto=format&n=_84snNj2y4O4wlvX&q=85&s=4af067d50a0ec61cba78d505098338a8" alt="Bot Referrals By Day" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-referrals-by-day.png" />

        ```http theme={null}
        POST /v1/reports/referrals HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-12",
          "end_date": "2025-12-18",
          "dimensions": ["date"],
          "filters": [
            {"field": "referral_source", "operator": "not_in", "value": ["none", "other", "internal"]}
          ],
          "order_by": {"date": "desc"},
          "metrics": ["visits"]
        }
        ```

        ```json theme={null}
        {
          "info": {},  // removed for brevity
          "data": [
            {
              "metrics": [
                977
              ],
              "dimensions": [
                "2025-12-18"
              ]
            },
            {
              "metrics": [
                906
              ],
              "dimensions": [
                "2025-12-17"
              ]
            },
            {
              "metrics": [
                719
              ],
              "dimensions": [
                "2025-12-16"
              ]
            },
            {
              "metrics": [
                571
              ],
              "dimensions": [
                "2025-12-15"
              ]
            },
            {
              "metrics": [
                665
              ],
              "dimensions": [
                "2025-12-14"
              ]
            },
            {
              "metrics": [
                655
              ],
              "dimensions": [
                "2025-12-13"
              ]
            },
            {
              "metrics": [
                844
              ],
              "dimensions": [
                "2025-12-12"
              ]
            }
          ]
        }
        ```
      </Tab>

      <Tab title="ページ単位のリファラル">
        特定のページ別にリファラル数を取得します。

        <Info>
          検索バーに `/blog` が入力されていることに注目してください。
        </Info>

        <img src="https://mintcdn.com/profound-37face47/_84snNj2y4O4wlvX/images/rest-api/aa-examples/get-referrals-by-page.png?fit=max&auto=format&n=_84snNj2y4O4wlvX&q=85&s=bcd6917a05026d5aae2d3d95391101c9" alt="Page Level Referrals" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-referrals-by-page.png" />

        <Tip>
          **% of Bot Referrals** は、リファラルの総数を合計し、各ボットのリファラル数をその合計で割ることで算出できます。
        </Tip>

        ```http theme={null}
        POST /v1/reports/referrals HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-12",
          "end_date": "2025-12-18",
          "dimensions": ["path"],
          "filters": [
            {"field": "referral_source", "operator": "not_in", "value": ["none", "other", "internal"]},
            {"field": "path", "operator": "contains", "value": "/blog"}
          ],
          "metrics": ["visits"],
          "order_by": {"visits": "desc"},
          "pagination": {"limit": 10, "offset": 0}
        }
        ```

        ```json theme={null}
        {
          "info": {},  // removed for brevity
          "data": [
            {
              "metrics": [
                915
              ],
              "dimensions": [
                "/blog/ai-platform-citation-patterns"
              ]
            },
            {
              "metrics": [
                350
              ],
              "dimensions": [
                "/blog/bring-profound-data-directly-into-your-ai-workflow-with-mcp"
              ]
            },
            {
              "metrics": [
                99
              ],
              "dimensions": [
                "/blog/citation-overlap-strategy"
              ]
            },
            {
              "metrics": [
                87
              ],
              "dimensions": [
                "/blog/the-data-on-reddit-and-ai-search"
              ]
            },
            {
              "metrics": [
                65
              ],
              "dimensions": [
                "/blog/best-generative-engine-optimization-tools"
              ]
            },
            {
              "metrics": [
                58
              ],
              "dimensions": [
                "/blog/chatgpt-entity-update"
              ]
            },
            {
              "metrics": [
                56
              ],
              "dimensions": [
                "/blog/prompt-volumes-the-new-way-to-see-what-customers-ask-answer-engines"
              ]
            },
            {
              "metrics": [
                50
              ],
              "dimensions": [
                "/blog/seeing-what-customers-see-direct-ai-search-engine-monitoring-vs-api-limitations"
              ]
            },
            {
              "metrics": [
                40
              ],
              "dimensions": [
                "/blog/choosing-ai-visibility-provider"
              ]
            },
            {
              "metrics": [
                33
              ],
              "dimensions": [
                "/blog/ai-search-volatility"
              ]
            }
          ]
        }
        ```
      </Tab>

      <Tab title="ボット別のリファラル">
        ボット別にリファラル数を取得します。

        <img src="https://mintcdn.com/profound-37face47/_84snNj2y4O4wlvX/images/rest-api/aa-examples/get-referrals-by-bot.png?fit=max&auto=format&n=_84snNj2y4O4wlvX&q=85&s=a50dbee002c88fe8a851dc3c3de364fa" alt="Referrals By Bot" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-referrals-by-bot.png" />

        <Tip>
          ここでの **% of Referrals** は、内部以外のソースからのリファラル訪問のうち、このボットからのものが占める割合を意味します。

          これを算出するには、レスポンス内のリファラルの総数を合計します。

          `total_referrals = 222126 + 5172 + 102 + 39 + 22 + 2 = 227481`

          次に、各ボットについて、そのリファラル数を合計で割ります。

          `ChatGPT % = (5172 / 227481) * 100 = 2.27%`

          ...
        </Tip>

        ```http theme={null}
        POST /v1/reports/referrals HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-12",
          "end_date": "2025-12-18",
          "dimensions": ["referral_source"],
          "filters": [
            {"field": "referral_source", "operator": "not_in", "value": ["none", "internal"]}
          ],
          "metrics": ["visits"],
          "order_by": {"visits": "desc"}
        }
        ```

        ```json theme={null}
        {
          "info": {},  // removed for brevity
          "data": [
            {
              "metrics": [
                222126
              ],
              "dimensions": [
                "other"
              ]
            },
            {
              "metrics": [
                5172
              ],
              "dimensions": [
                "openai"
              ]
            },
            {
              "metrics": [
                102
              ],
              "dimensions": [
                "perplexity"
              ]
            },
            {
              "metrics": [
                39
              ],
              "dimensions": [
                "gemini"
              ]
            },
            {
              "metrics": [
                22
              ],
              "dimensions": [
                "anthropic"
              ]
            },
            {
              "metrics": [
                2
              ],
              "dimensions": [
                "deepseek"
              ]
            }
          ]
        }
        ```
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="時間単位レポート (V2)">
    V2 エンドポイントは、UTC の時間単位でデータをバケット化した**時間単位の粒度**のレポートを提供します。V1 と同じディメンション、指標、フィルターをすべてサポートしているほか、時間単位のテーブルに固有の新しいフィールドとして、**UTM** と**リファラル**のトラフィックの区別も提供します。

    V1 の日次集計は ET に固定されているため、他のタイムゾーンのユーザーは、自分のローカルの日単位でバケット化されたデータを取得する方法がありませんでした。V2 はこの問題を解決します。データが UTC の時間単位でバケット化されるため、ローカルの日の境界を UTC に変換し、自分の暦日に合わせたデータをクエリできます。

    <Info>
      **V1 と V2:** 日次の事前集計レポート(EST ベース)には **日次レポート (V1)** タブを
      使用してください。V2 は時間単位の粒度(UTC)向けです。実行ごとの Raw の
      プロンプト回答行は `POST /v2/prompts/answers` で取得できます。
    </Info>

    <Warning>
      **端数オフセットのタイムゾーン:** ローカルのタイムゾーンが端数の UTC オフセット(例: IST +5:30、ネパール +5:45)を使用している場合、ローカルの 1 時間は 2 つの UTC 時間バケットにまたがります。時間単位の粒度でクエリする場合は、そのローカルの 1 時間分の完全なデータを取得するために、**連続する 2 時間分**をリクエストしてください。詳細は [日付範囲とタイムゾーン](/ja-jp/rest-api/date-ranges#fractional-offset-timezones) を参照してください。
    </Warning>

    ## ボットレポート

    時間単位のボット内訳テーブルから集計したボットトラフィックデータを返します。

    <Tabs>
      <Tab title="ボットのハイライト">
        ボットの種類別に訪問数を取得します。

        <img src="https://mintcdn.com/profound-37face47/_84snNj2y4O4wlvX/images/rest-api/aa-examples/get-bot-visit-highlights.png?fit=max&auto=format&n=_84snNj2y4O4wlvX&q=85&s=f61cba46eb807a2712365c4ad71b8e1e" alt="Dashboard Metrics" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-bot-visit-highlights.png" />

        ```http theme={null}
        POST /v2/reports/bots HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-12",
          "end_date": "2025-12-18",
          "metrics": ["citations", "training", "indexing"]
        }
        ```
      </Tab>

      <Tab title="日別の引用">
        ChatGPT の引用数を日別に取得します。

        <img src="https://mintcdn.com/profound-37face47/_84snNj2y4O4wlvX/images/rest-api/aa-examples/get-citations-by-bot-by-day.png?fit=max&auto=format&n=_84snNj2y4O4wlvX&q=85&s=42042eb802d987cc0f20ede22bedfe1a" alt="By Day Breakdown" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-citations-by-bot-by-day.png" />

        ```http theme={null}
        POST /v2/reports/bots HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-12",
          "end_date": "2025-12-18",
          "dimensions": ["date"],
          "filters": [
            { "field": "bot_name", "operator": "is", "value": "ChatGPT-User" }
          ],
          "order_by": { "date": "desc" },
          "metrics": ["citations"]
        }
        ```
      </Tab>

      <Tab title="プロバイダー別のページ訪問">
        特定のプロバイダーについて、引用数の多い上位パスを取得します。

        <img src="https://mintcdn.com/profound-37face47/_84snNj2y4O4wlvX/images/rest-api/aa-examples/get-page-visits-by-provider.png?fit=max&auto=format&n=_84snNj2y4O4wlvX&q=85&s=2234a9d846acd32bf2379d7ceca88089" alt="Page Visits by Provider" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-page-visits-by-provider.png" />

        ```http theme={null}
        POST /v2/reports/bots HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-12",
          "end_date": "2025-12-18",
          "dimensions": ["path"],
          "filters": [
            { "field": "bot_provider", "operator": "is", "value": "openai" }
          ],
          "order_by": { "citations": "desc" },
          "metrics": ["citations", "indexing", "training"],
          "pagination": { "limit": 10, "offset": 0 }
        }
        ```
      </Tab>

      <Tab title="時間別のボットトラフィック">
        UTC の 1 日分について、時間別のボットトラフィックの内訳を取得します。UTC タイムスタンプを使用して、クエリをローカルの暦日に合わせます。

        ```http theme={null}
        POST /v2/reports/bots HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-16T00:00:00Z",
          "end_date": "2025-12-16T23:59:59Z",
          "dimensions": ["hour"],
          "metrics": ["count", "citations"],
          "order_by": { "hour": "asc" }
        }
        ```
      </Tab>
    </Tabs>

    ### リクエストボディ

    <table style={{ tableLayout: "fixed", width: "100%" }}>
      <colgroup>
        <col style={{ width: "26%" }} />

        <col style={{ width: "9%" }} />

        <col style={{ width: "8%" }} />

        <col style={{ width: "17%" }} />

        <col style={{ width: "40%" }} />
      </colgroup>

      <thead>
        <tr>
          <th style={{ whiteSpace: "nowrap" }}>フィールド</th>
          <th>型</th>
          <th>必須</th>
          <th>デフォルト</th>
          <th style={{ fontSize: "0.9em" }}>説明</th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>domain</code></td>
          <td>string</td>
          <td>はい</td>
          <td>-</td>
          <td style={{ fontSize: "0.9em" }}>クエリ対象のドメイン(例: <code>[www.tryprofound.com](http://www.tryprofound.com)</code>)</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>start\_date</code></td>
          <td>string</td>
          <td>はい</td>
          <td>-</td>
          <td style={{ fontSize: "0.9em" }}>UTC での開始日。<code>YYYY-MM-DD</code>、<code>YYYY-MM-DD HH:MM</code>、<code>YYYY-MM-DD HH:MM:SS</code>、または完全な ISO タイムスタンプを受け付けます</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>end\_date</code></td>
          <td>string</td>
          <td>いいえ</td>
          <td>現在時刻 (UTC)</td>
          <td style={{ fontSize: "0.9em" }}>UTC での終了日。start\_date と同じ形式です</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>metrics</code></td>
          <td>string\[]</td>
          <td>はい</td>
          <td>-</td>
          <td style={{ fontSize: "0.9em" }}>返す 1 つ以上の指標(下記参照)</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>dimensions</code></td>
          <td>string\[]</td>
          <td>いいえ</td>
          <td><code>\[]</code></td>
          <td style={{ fontSize: "0.9em" }}>結果のグループ化に使用するフィールド(下記参照)</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>filters</code></td>
          <td>filter\[]</td>
          <td>いいえ</td>
          <td><code>\[]</code></td>
          <td style={{ fontSize: "0.9em" }}>結果を絞り込むためのフィルター(下記参照)</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>date\_interval</code></td>
          <td>string</td>
          <td>いいえ</td>
          <td><code>"day"</code></td>
          <td style={{ fontSize: "0.9em" }}><code>date</code> ディメンションのバケットサイズ: <code>"hour"</code> または <code>"day"</code></td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>order\_by</code></td>
          <td>object</td>
          <td>いいえ</td>
          <td>最初の指標の降順</td>
          <td style={{ fontSize: "0.9em" }}>フィールド → <code>"asc"</code> または <code>"desc"</code> のマップ</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>pagination</code></td>
          <td>object</td>
          <td>いいえ</td>
          <td><code>{'{'} limit: 10000, offset: 0 {'}'}</code></td>
          <td style={{ fontSize: "0.9em" }}>ページネーションの設定</td>
        </tr>
      </tbody>
    </table>

    ### 指標

    | 指標 | 説明 |
    | - | - |
    | `count` | ユニークなボット訪問の合計(すべてのボットの種類) |
    | `citations` | AI アシスタントボット(例: ChatGPT-User、Perplexity-User)からのユニーク訪問数 |
    | `indexing` | Web インデックスボット(例: Googlebot、bingbot)からのユニーク訪問数 |
    | `training` | AI トレーニングボット(例: GPTBot、ClaudeBot)からのユニーク訪問数 |
    | `last_visit` | 最新の訪問のタイムスタンプ |

    ### ディメンション

    | ディメンション | 説明 |
    | - | - |
    | `date` | `date_interval`(日または時間)でバケット化。UTC ベース |
    | `hour` | 未加工の UTC 時間バケット — 追加の集計なしの `date` + `date_interval: "hour"` と同等 |
    | `path` | URL パス |
    | `bot_name` | ボット名(例: `ChatGPT-User`、`GPTBot`) |
    | `bot_provider` | ボットのプロバイダー(例: `openai`、`anthropic`) |
    | `bot_type` | ボットのカテゴリ: `ai_assistant`、`index`、`ai_training`、`ai_agent` |

    ### フィルター

    | フィールド | 演算子 | 値 |
    | - | - | - |
    | `path` | `is`, `not_is`, `contains`, `not_contains`, `in`, `not_in` | URL パスの文字列 |
    | `bot_name` | `is`, `not_is`, `contains`, `not_contains`, `in`, `not_in` | ボット名の文字列 |
    | `bot_provider` | `is`, `not_is`, `contains`, `not_contains`, `in`, `not_in` | プロバイダーの文字列 |
    | `bot_type` | `is`, `not_is`, `in`, `not_in` | `ai_assistant`, `index`, `ai_training`, `ai_agent` |

    ***

    ## リファラルレポート

    時間単位のリファラル内訳テーブルから集計したリファラルトラフィックデータを返します。

    <Tabs>
      <Tab title="プラットフォーム別のリファラル">
        プラットフォーム別にリファラル数を取得します(内部トラフィックを除く)。

        <img src="https://mintcdn.com/profound-37face47/_84snNj2y4O4wlvX/images/rest-api/aa-examples/get-referrals-by-platform.png?fit=max&auto=format&n=_84snNj2y4O4wlvX&q=85&s=d4ef5e6ecb21e0f05cd03cbcc07fa22b" alt="Referrals By Platform" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-referrals-by-platform.png" />

        ```http theme={null}
        POST /v2/reports/referrals HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-12",
          "end_date": "2025-12-18",
          "dimensions": ["referral_source"],
          "filters": [
            { "field": "referral_source", "operator": "not_in", "value": ["none", "internal"] }
          ],
          "metrics": ["visits"]
        }
        ```
      </Tab>

      <Tab title="日別のボットリファラル">
        AI ボットからのリファラル数を日別に取得します。

        <img src="https://mintcdn.com/profound-37face47/_84snNj2y4O4wlvX/images/rest-api/aa-examples/get-referrals-by-day.png?fit=max&auto=format&n=_84snNj2y4O4wlvX&q=85&s=4af067d50a0ec61cba78d505098338a8" alt="Bot Referrals By Day" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-referrals-by-day.png" />

        ```http theme={null}
        POST /v2/reports/referrals HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-12",
          "end_date": "2025-12-18",
          "dimensions": ["date"],
          "filters": [
            { "field": "referral_source", "operator": "not_in", "value": ["none", "other", "internal"] }
          ],
          "order_by": { "date": "desc" },
          "metrics": ["visits"]
        }
        ```
      </Tab>

      <Tab title="ページ単位のリファラル">
        外部リファラル訪問数の多い上位のブログパスを取得します。

        <img src="https://mintcdn.com/profound-37face47/_84snNj2y4O4wlvX/images/rest-api/aa-examples/get-referrals-by-page.png?fit=max&auto=format&n=_84snNj2y4O4wlvX&q=85&s=bcd6917a05026d5aae2d3d95391101c9" alt="Page Level Referrals" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-referrals-by-page.png" />

        ```http theme={null}
        POST /v2/reports/referrals HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-12",
          "end_date": "2025-12-18",
          "dimensions": ["path"],
          "filters": [
            { "field": "referral_source", "operator": "not_in", "value": ["none", "other", "internal"] },
            { "field": "path", "operator": "contains", "value": "/blog" }
          ],
          "metrics": ["visits"],
          "order_by": { "visits": "desc" },
          "pagination": { "limit": 10, "offset": 0 }
        }
        ```
      </Tab>

      <Tab title="ボット別のリファラル">
        訪問数で順位付けした上位のリファラルソースを取得します。

        <img src="https://mintcdn.com/profound-37face47/_84snNj2y4O4wlvX/images/rest-api/aa-examples/get-referrals-by-bot.png?fit=max&auto=format&n=_84snNj2y4O4wlvX&q=85&s=a50dbee002c88fe8a851dc3c3de364fa" alt="Referrals By Bot" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-referrals-by-bot.png" />

        ```http theme={null}
        POST /v2/reports/referrals HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-12",
          "end_date": "2025-12-18",
          "dimensions": ["referral_source"],
          "filters": [
            { "field": "referral_source", "operator": "not_in", "value": ["none", "internal"] }
          ],
          "metrics": ["visits"],
          "order_by": { "visits": "desc" }
        }
        ```
      </Tab>

      <Tab title="UTM トラフィック">
        UTM リファラルトラフィックを時間別に取得します。

        <img src="https://mintcdn.com/profound-37face47/gM-2pDTh8T5hVvln/images/rest-api/aa-examples/get-utm-traffic-hourly.png?fit=max&auto=format&n=gM-2pDTh8T5hVvln&q=85&s=ef4d4e3f68a345f9a9cd96705066c04e" alt="Hourly UTM Traffic" width="3456" height="1984" data-path="images/rest-api/aa-examples/get-utm-traffic-hourly.png" />

        ```http theme={null}
        POST /v2/reports/referrals HTTP/1.1
        Content-Type: application/json
        X-API-Key: your_api_key

        {
          "domain": "www.tryprofound.com",
          "start_date": "2025-12-16",
          "end_date": "2025-12-17",
          "dimensions": ["hour"],
          "filters": [
            { "field": "referral_type", "operator": "is", "value": "utm" }
          ],
          "metrics": ["visits"],
          "order_by": { "hour": "asc" }
        }
        ```
      </Tab>
    </Tabs>

    ### リクエストボディ

    <table style={{ tableLayout: "fixed", width: "100%" }}>
      <colgroup>
        <col style={{ width: "26%" }} />

        <col style={{ width: "9%" }} />

        <col style={{ width: "8%" }} />

        <col style={{ width: "17%" }} />

        <col style={{ width: "40%" }} />
      </colgroup>

      <thead>
        <tr>
          <th style={{ whiteSpace: "nowrap" }}>フィールド</th>
          <th>型</th>
          <th>必須</th>
          <th>デフォルト</th>
          <th style={{ fontSize: "0.9em" }}>説明</th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>domain</code></td>
          <td>string</td>
          <td>はい</td>
          <td>-</td>
          <td style={{ fontSize: "0.9em" }}>クエリ対象のドメイン</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>start\_date</code></td>
          <td>string</td>
          <td>はい</td>
          <td>-</td>
          <td style={{ fontSize: "0.9em" }}>UTC での開始日。<code>YYYY-MM-DD</code>、<code>YYYY-MM-DD HH:MM</code>、<code>YYYY-MM-DD HH:MM:SS</code>、または完全な ISO タイムスタンプを受け付けます</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>end\_date</code></td>
          <td>string</td>
          <td>いいえ</td>
          <td>現在時刻 (UTC)</td>
          <td style={{ fontSize: "0.9em" }}>UTC での終了日。start\_date と同じ形式です</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>metrics</code></td>
          <td>string\[]</td>
          <td>はい</td>
          <td>-</td>
          <td style={{ fontSize: "0.9em" }}>返す 1 つ以上の指標(下記参照)</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>dimensions</code></td>
          <td>string\[]</td>
          <td>いいえ</td>
          <td><code>\[]</code></td>
          <td style={{ fontSize: "0.9em" }}>結果のグループ化に使用するフィールド(下記参照)</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>filters</code></td>
          <td>filter\[]</td>
          <td>いいえ</td>
          <td><code>\[]</code></td>
          <td style={{ fontSize: "0.9em" }}>結果を絞り込むためのフィルター(下記参照)</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>date\_interval</code></td>
          <td>string</td>
          <td>いいえ</td>
          <td><code>"day"</code></td>
          <td style={{ fontSize: "0.9em" }}><code>date</code> ディメンションのバケットサイズ: <code>"hour"</code> または <code>"day"</code></td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>order\_by</code></td>
          <td>object</td>
          <td>いいえ</td>
          <td>最初の指標の降順</td>
          <td style={{ fontSize: "0.9em" }}>フィールド → <code>"asc"</code> または <code>"desc"</code> のマップ</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>pagination</code></td>
          <td>object</td>
          <td>いいえ</td>
          <td><code>{'{'} limit: 10000, offset: 0 {'}'}</code></td>
          <td style={{ fontSize: "0.9em" }}>ページネーションの設定</td>
        </tr>
      </tbody>
    </table>

    ### 指標

    | 指標 | 説明 |
    | - | - |
    | `visits` | ユニークなページ訪問数 |
    | `last_visit` | 最新の訪問のタイムスタンプ |

    ### ディメンション

    | ディメンション | 説明 |
    | - | - |
    | `date` | `date_interval`(日または時間)でバケット化。UTC ベース |
    | `hour` | 未加工の UTC 時間バケット — 追加の集計なしの `date` + `date_interval: "hour"` と同等 |
    | `path` | URL パス |
    | `referral_source` | リファラルソース(例: `openai`、`perplexity`、`anthropic`、`other`、`internal`、`none`) |
    | `referral_type` | トラフィックのカテゴリ: `internal`、`referer`、`utm`、`none` |

    ### フィルター

    | フィールド | 演算子 | 値 |
    | - | - | - |
    | `path` | `is`, `not_is`, `contains`, `not_contains`, `in`, `not_in` | URL パスの文字列 |
    | `referral_source` | `is`, `not_is`, `contains`, `not_contains`, `in`, `not_in` | リファラルソースの文字列 |
    | `referral_type` | `is`, `not_is`, `in`, `not_in` | `internal`, `referer`, `utm`, `none` |

    ***
  </Tab>
</Tabs>

## Raw データ

<Warning>
  Agent Analytics の Raw エンドポイント `POST /v1/logs/raw` および
  `POST /v1/logs/raw/bots` は 2026-06-10 に廃止されました。集計済みのトラフィックデータには
  [V2 のボットおよびリファラルレポートの例](/ja-jp/rest-api/examples/agent-analytics) を、
  実行ごとの Raw 行には [V2 のプロンプト回答](/ja-jp/rest-api/reports/query-answers-v2) を
  使用してください。
</Warning>