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

> Solicitudes de ejemplo para los endpoints de Agent Analytics.

Esta guía ofrece ejemplos prácticos de solicitudes comunes a la API. Todos los ejemplos usan formato JSON y requieren autenticación mediante clave de API.

# Informes

<Tabs>
  <Tab title="Informes diarios (V1)">
    Ejemplos para los endpoints de informes **V1** (`/v1/reports/*`): datos diarios preagregados en EST.
    Para una granularidad por hora, usa la pestaña **Informes por hora (V2)** de arriba.

    <Info>
      Los endpoints de registros sin procesar de Agent Analytics están retirados. Para obtener filas
      sin procesar de respuestas a prompts por ejecución, usa `POST /v2/prompts/answers`. Para el tráfico de bots y de
      referidos, usa los endpoints agregados `/v2/reports/bots` y `/v2/reports/referrals`.
    </Info>

    * **Capacidad:** rangos de fechas completos en una sola solicitud mediante los endpoints de informes agregados.
    * **Granularidad:** los datos se agrupan por día. Las marcas de tiempo se normalizan al inicio de cada día en EST.

    ## Informes de bots

    <Tabs>
      <Tab title="Aspectos destacados de bots">
        Obtén un recuento de visitas por tipo de bot:

        <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="Métricas del panel" 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="Citas por día">
        Obtén un recuento de citas de ChatGPT por día:

        <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="Desglose por día" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-citations-by-bot-by-day.png" />

        <Tip>
          Ten en cuenta que puedes obtener fácilmente la lista diaria completa desglosada por bot sustituyendo:

          ```
          "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="Visitas a páginas por proveedor">
        Obtén un recuento de visitas a páginas por tipo de bot, limitado a un proveedor:

        <Info>
          Observa la selección de OpenAI en **Platforms**, arriba a la derecha.
        </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="Visitas a páginas por proveedor" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-page-visits-by-provider.png" />

        <Tip>
          Consulta las métricas de todos los proveedores eliminando el filtro.
        </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>

    ## Informes de referidos

    <Tabs>
      <Tab title="Referidos por plataforma">
        Obtén un recuento de referidos desglosado por plataforma:

        <Info>
          Nota:

          `other` representa los referidos de **fuentes tradicionales**, por ejemplo LinkedIn, Facebook, etc.

          `internal` representa los referidos desde tu propio sitio web, por ejemplo una entrada de blog que enlaza a otra entrada de blog.
        </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="Referidos por plataforma" 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="Referidos de bots por día">
        Obtén un recuento de referidos de bots de IA desglosado por día:

        <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="Referidos de bots por día" 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="Referidos por página">
        Obtén un recuento de referidos desglosado por una página determinada:

        <Info>
          Observa `/blog` en la barra de búsqueda.
        </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="Referidos por página" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-referrals-by-page.png" />

        <Tip>
          El **% de referidos de bots** se puede calcular sumando el número total de referidos y dividiendo los referidos de cada bot entre el total.
        </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="Referidos por bot">
        Obtén un recuento de referidos desglosado por bot:

        <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="Referidos por bot" width="3680" height="2390" data-path="images/rest-api/aa-examples/get-referrals-by-bot.png" />

        <Tip>
          Aquí, el **% de referidos** es la proporción de visitas referidas desde fuentes no internas que provienen de este bot.

          Para calcularlo, suma el número total de referidos en la respuesta:

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

          Luego, para cada bot, divide sus referidos entre el total:

          `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="Informes por hora (V2)">
    Los endpoints V2 ofrecen informes con **granularidad por hora**, con los datos agrupados por hora UTC. Admiten las mismas dimensiones, métricas y filtros que V1, además de nuevos campos exclusivos de las tablas por hora: la distinción entre tráfico **UTM** y de **referidos**.

    Los agregados diarios de V1 están fijados en ET, lo que significa que los usuarios de otras zonas horarias no podían obtener datos agrupados según sus propios días locales. V2 resuelve esto: como los datos se agrupan por hora UTC, puedes convertir los límites de tu día local a UTC y consultar datos que coincidan con tus propios días naturales.

    <Info>
      **V1 frente a V2:** usa la pestaña **V1 (diario)** para informes diarios preagregados
      (basados en EST). V2 es para granularidad por hora (UTC). Las filas sin procesar de
      respuestas a prompts por ejecución están disponibles mediante `POST /v2/prompts/answers`.
    </Info>

    <Warning>
      **Zonas horarias con desfase fraccionario:** si tu zona horaria local usa un desfase UTC fraccionario (por ejemplo, IST +5:30, Nepal +5:45), una sola hora local abarca dos intervalos de hora UTC. Al consultar con granularidad por hora, solicita **2 horas consecutivas** para obtener datos completos de esa hora local. Consulta [Rangos de fechas y zonas horarias](/es/rest-api/date-ranges#fractional-offset-timezones) para más detalles.
    </Warning>

    ## Informes de bots

    Devuelve datos de tráfico de bots agregados a partir de la tabla de desglose de bots por hora.

    <Tabs>
      <Tab title="Aspectos destacados de bots">
        Obtén un recuento de visitas por tipo de bot:

        <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="Métricas del panel" 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="Citas por día">
        Obtén un recuento de citas de ChatGPT por día:

        <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="Desglose por día" 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="Visitas a páginas por proveedor">
        Obtén las rutas principales por citas para un proveedor específico:

        <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="Visitas a páginas por proveedor" 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="Tráfico de bots por hora">
        Obtén el desglose por hora del tráfico de bots para un día UTC. Usa marcas de tiempo UTC para alinear la consulta con tu día natural local:

        ```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>

    ### Cuerpo de la solicitud

    <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" }}>Campo</th>
          <th>Tipo</th>
          <th>Obligatorio</th>
          <th>Predeterminado</th>
          <th style={{ fontSize: "0.9em" }}>Descripción</th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>domain</code></td>
          <td>string</td>
          <td>sí</td>
          <td>-</td>
          <td style={{ fontSize: "0.9em" }}>Dominio que se consulta (p. ej., <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>sí</td>
          <td>-</td>
          <td style={{ fontSize: "0.9em" }}>Fecha de inicio en UTC. Acepta <code>YYYY-MM-DD</code>, <code>YYYY-MM-DD HH:MM</code>, <code>YYYY-MM-DD HH:MM:SS</code> o una marca de tiempo ISO completa</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>end\_date</code></td>
          <td>string</td>
          <td>no</td>
          <td>ahora (UTC)</td>
          <td style={{ fontSize: "0.9em" }}>Fecha de fin en UTC. Mismos formatos que start\_date</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>metrics</code></td>
          <td>string\[]</td>
          <td>sí</td>
          <td>-</td>
          <td style={{ fontSize: "0.9em" }}>Una o más métricas que se devolverán (ver más abajo)</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>dimensions</code></td>
          <td>string\[]</td>
          <td>no</td>
          <td><code>\[]</code></td>
          <td style={{ fontSize: "0.9em" }}>Campos por los que agrupar los resultados (ver más abajo)</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>filters</code></td>
          <td>filter\[]</td>
          <td>no</td>
          <td><code>\[]</code></td>
          <td style={{ fontSize: "0.9em" }}>Filtros para acotar los resultados (ver más abajo)</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>date\_interval</code></td>
          <td>string</td>
          <td>no</td>
          <td><code>"day"</code></td>
          <td style={{ fontSize: "0.9em" }}>Tamaño del intervalo para la dimensión <code>date</code>: <code>"hour"</code> o <code>"day"</code></td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>order\_by</code></td>
          <td>object</td>
          <td>no</td>
          <td>primera métrica desc</td>
          <td style={{ fontSize: "0.9em" }}>Mapa de campo -> <code>"asc"</code> o <code>"desc"</code></td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>pagination</code></td>
          <td>object</td>
          <td>no</td>
          <td><code>{'{'} limit: 10000, offset: 0 {'}'}</code></td>
          <td style={{ fontSize: "0.9em" }}>Configuración de paginación</td>
        </tr>
      </tbody>
    </table>

    ### Métricas

    | Métrica | Descripción |
    | - | - |
    | `count` | Total de visitas únicas de bots (todos los tipos de bots) |
    | `citations` | Visitas únicas de bots de asistentes de IA (p. ej., ChatGPT-User, Perplexity-User) |
    | `indexing` | Visitas únicas de bots de indexación web (p. ej., Googlebot, bingbot) |
    | `training` | Visitas únicas de bots de entrenamiento de IA (p. ej., GPTBot, ClaudeBot) |
    | `last_visit` | Marca de tiempo de la visita más reciente |

    ### Dimensiones

    | Dimensión | Descripción |
    | - | - |
    | `date` | Agrupado por `date_interval` (día u hora). Basado en UTC |
    | `hour` | Intervalo de hora UTC sin procesar: equivale a `date` + `date_interval: "hour"` sin agregación adicional |
    | `path` | Ruta de la URL |
    | `bot_name` | Nombre del bot (p. ej., `ChatGPT-User`, `GPTBot`) |
    | `bot_provider` | Proveedor del bot (p. ej., `openai`, `anthropic`) |
    | `bot_type` | Categoría del bot: `ai_assistant`, `index`, `ai_training`, `ai_agent` |

    ### Filtros

    | Campo | Operadores | Valores |
    | - | - | - |
    | `path` | `is`, `not_is`, `contains`, `not_contains`, `in`, `not_in` | Cadena de ruta de la URL |
    | `bot_name` | `is`, `not_is`, `contains`, `not_contains`, `in`, `not_in` | Cadena con el nombre del bot |
    | `bot_provider` | `is`, `not_is`, `contains`, `not_contains`, `in`, `not_in` | Cadena del proveedor |
    | `bot_type` | `is`, `not_is`, `in`, `not_in` | `ai_assistant`, `index`, `ai_training`, `ai_agent` |

    ***

    ## Informes de referidos

    Devuelve datos de tráfico de referidos agregados a partir de la tabla de desglose de referidos por hora.

    <Tabs>
      <Tab title="Referidos por plataforma">
        Obtén un recuento de referidos desglosado por plataforma (excluido el tráfico interno):

        <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="Referidos por plataforma" 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="Referidos de bots por día">
        Obtén un recuento de referidos de bots de IA desglosado por día:

        <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="Referidos de bots por día" 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="Referidos por página">
        Obtén las rutas principales del blog por visitas referidas externas:

        <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="Referidos por página" 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="Referidos por bot">
        Obtén las principales fuentes de referidos ordenadas por visitas:

        <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="Referidos por 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="Tráfico UTM">
        Obtén el tráfico de referidos UTM por hora:

        <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="Tráfico UTM por hora" 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>

    ### Cuerpo de la solicitud

    <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" }}>Campo</th>
          <th>Tipo</th>
          <th>Obligatorio</th>
          <th>Predeterminado</th>
          <th style={{ fontSize: "0.9em" }}>Descripción</th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>domain</code></td>
          <td>string</td>
          <td>sí</td>
          <td>-</td>
          <td style={{ fontSize: "0.9em" }}>Dominio que se consulta</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>start\_date</code></td>
          <td>string</td>
          <td>sí</td>
          <td>-</td>
          <td style={{ fontSize: "0.9em" }}>Fecha de inicio en UTC. Acepta <code>YYYY-MM-DD</code>, <code>YYYY-MM-DD HH:MM</code>, <code>YYYY-MM-DD HH:MM:SS</code> o una marca de tiempo ISO completa</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>end\_date</code></td>
          <td>string</td>
          <td>no</td>
          <td>ahora (UTC)</td>
          <td style={{ fontSize: "0.9em" }}>Fecha de fin en UTC. Mismos formatos que start\_date</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>metrics</code></td>
          <td>string\[]</td>
          <td>sí</td>
          <td>-</td>
          <td style={{ fontSize: "0.9em" }}>Una o más métricas que se devolverán (ver más abajo)</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>dimensions</code></td>
          <td>string\[]</td>
          <td>no</td>
          <td><code>\[]</code></td>
          <td style={{ fontSize: "0.9em" }}>Campos por los que agrupar los resultados (ver más abajo)</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>filters</code></td>
          <td>filter\[]</td>
          <td>no</td>
          <td><code>\[]</code></td>
          <td style={{ fontSize: "0.9em" }}>Filtros para acotar los resultados (ver más abajo)</td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>date\_interval</code></td>
          <td>string</td>
          <td>no</td>
          <td><code>"day"</code></td>
          <td style={{ fontSize: "0.9em" }}>Tamaño del intervalo para la dimensión <code>date</code>: <code>"hour"</code> o <code>"day"</code></td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>order\_by</code></td>
          <td>object</td>
          <td>no</td>
          <td>primera métrica desc</td>
          <td style={{ fontSize: "0.9em" }}>Mapa de campo -> <code>"asc"</code> o <code>"desc"</code></td>
        </tr>

        <tr>
          <td style={{ whiteSpace: "nowrap" }}><code>pagination</code></td>
          <td>object</td>
          <td>no</td>
          <td><code>{'{'} limit: 10000, offset: 0 {'}'}</code></td>
          <td style={{ fontSize: "0.9em" }}>Configuración de paginación</td>
        </tr>
      </tbody>
    </table>

    ### Métricas

    | Métrica | Descripción |
    | - | - |
    | `visits` | Visitas únicas a páginas |
    | `last_visit` | Marca de tiempo de la visita más reciente |

    ### Dimensiones

    | Dimensión | Descripción |
    | - | - |
    | `date` | Agrupado por `date_interval` (día u hora). Basado en UTC |
    | `hour` | Intervalo de hora UTC sin procesar: equivale a `date` + `date_interval: "hour"` sin agregación adicional |
    | `path` | Ruta de la URL |
    | `referral_source` | Fuente de referido (p. ej., `openai`, `perplexity`, `anthropic`, `other`, `internal`, `none`) |
    | `referral_type` | Categoría de tráfico: `internal`, `referer`, `utm`, `none` |

    ### Filtros

    | Campo | Operadores | Valores |
    | - | - | - |
    | `path` | `is`, `not_is`, `contains`, `not_contains`, `in`, `not_in` | Cadena de ruta de la URL |
    | `referral_source` | `is`, `not_is`, `contains`, `not_contains`, `in`, `not_in` | Cadena de la fuente de referido |
    | `referral_type` | `is`, `not_is`, `in`, `not_in` | `internal`, `referer`, `utm`, `none` |

    ***
  </Tab>
</Tabs>

## Datos sin procesar

<Warning>
  Los endpoints de datos sin procesar de Agent Analytics `POST /v1/logs/raw` y
  `POST /v1/logs/raw/bots` se retiraron el 2026-06-10. Usa los [ejemplos de informes V2 de bots y
  referidos](/es/rest-api/examples/agent-analytics) para datos de tráfico agregados,
  o [respuestas a prompts V2](/es/rest-api/reports/query-answers-v2) para filas sin procesar
  por ejecución.
</Warning>