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

Informes diarios (V1)
Informes por hora (V2)

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.

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.

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

Aspectos destacados de bots
Citas por día
Visitas a páginas por proveedor

Obtén un recuento de visitas por tipo de bot:

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"]
}

{
  "info": {},  // removed for brevity
  "data": [
    {
      "metrics": [
        20640,
        8450,
        3646
      ],
      "dimensions": []
    }
  ]
}

Obtén un recuento de citas de ChatGPT por día:

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

"dimensions": ["date", "bot_name"],
"filters": [],

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"]
}

{
    "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"
            ]
        }
    ]
}

Obtén un recuento de visitas a páginas por tipo de bot, limitado a un proveedor:

Observa la selección de OpenAI en Platforms, arriba a la derecha.

Consulta las métricas de todos los proveedores eliminando el filtro.

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

{
  "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"
        ]
      }
  ]
}

Informes de referidos

Referidos por plataforma
Referidos de bots por día
Referidos por página
Referidos por bot

Obtén un recuento de referidos desglosado por plataforma:

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.

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"]
}

{
  "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"
      ]
    }
  ]
}

Obtén un recuento de referidos de bots de IA desglosado por día:

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"]
}

{
  "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"
      ]
    }
  ]
}

Obtén un recuento de referidos desglosado por una página determinada:

Observa /blog en la barra de búsqueda.

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.

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

{
  "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"
      ]
    }
  ]
}

Obtén un recuento de referidos desglosado por bot:

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 = 227481Luego, para cada bot, divide sus referidos entre el total:ChatGPT % = (5172 / 227481) * 100 = 2.27%…

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"}
}

{
  "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"
      ]
    }
  ]
}

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.

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.

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 para más detalles.

Informes de bots

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

Aspectos destacados de bots
Citas por día
Visitas a páginas por proveedor
Tráfico de bots por hora

Obtén un recuento de visitas por tipo de bot:

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"]
}

Obtén un recuento de citas de ChatGPT por día:

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"]
}

Obtén las rutas principales por citas para un proveedor específico:

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

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:

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" }
}

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Predeterminado	Descripción
`domain`	string	sí	-	Dominio que se consulta (p. ej., `www.tryprofound.com`)
`start_date`	string	sí	-	Fecha de inicio en UTC. Acepta `YYYY-MM-DD`, `YYYY-MM-DD HH:MM`, `YYYY-MM-DD HH:MM:SS` o una marca de tiempo ISO completa
`end_date`	string	no	ahora (UTC)	Fecha de fin en UTC. Mismos formatos que start_date
`metrics`	string[]	sí	-	Una o más métricas que se devolverán (ver más abajo)
`dimensions`	string[]	no	`[]`	Campos por los que agrupar los resultados (ver más abajo)
`filters`	filter[]	no	`[]`	Filtros para acotar los resultados (ver más abajo)
`date_interval`	string	no	`”day”`	Tamaño del intervalo para la dimensión `date`: `“hour”` o `“day”`
`order_by`	object	no	primera métrica desc	Mapa de campo -> `“asc”` o `“desc”`
`pagination`	object	no	`limit: 10000, offset: 0`	Configuración de paginación

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.

Referidos por plataforma
Referidos de bots por día
Referidos por página
Referidos por bot
Tráfico UTM

Obtén un recuento de referidos desglosado por plataforma (excluido el tráfico interno):

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"]
}

Obtén un recuento de referidos de bots de IA desglosado por día:

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"]
}

Obtén las rutas principales del blog por visitas referidas externas:

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

Obtén las principales fuentes de referidos ordenadas por visitas:

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" }
}

Obtén el tráfico de referidos UTM por hora:

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" }
}

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Predeterminado	Descripción
`domain`	string	sí	-	Dominio que se consulta
`start_date`	string	sí	-	Fecha de inicio en UTC. Acepta `YYYY-MM-DD`, `YYYY-MM-DD HH:MM`, `YYYY-MM-DD HH:MM:SS` o una marca de tiempo ISO completa
`end_date`	string	no	ahora (UTC)	Fecha de fin en UTC. Mismos formatos que start_date
`metrics`	string[]	sí	-	Una o más métricas que se devolverán (ver más abajo)
`dimensions`	string[]	no	`[]`	Campos por los que agrupar los resultados (ver más abajo)
`filters`	filter[]	no	`[]`	Filtros para acotar los resultados (ver más abajo)
`date_interval`	string	no	`”day”`	Tamaño del intervalo para la dimensión `date`: `“hour”` o `“day”`
`order_by`	object	no	primera métrica desc	Mapa de campo -> `“asc”` o `“desc”`
`pagination`	object	no	`limit: 10000, offset: 0`	Configuración de paginación

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`

Datos sin procesar

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 para datos de tráfico agregados, o respuestas a prompts V2 para filas sin procesar por ejecución.

Descripción general

SDKs

Integraciones

Agentes

Organización

Categorías

Prompts

Bases de conocimiento

OpenAI Ads

Respuestas

Volúmenes de prompts

Informes

Optimización de contenido

Agent Analytics

Informes

Informes de bots

Informes de referidos

Informes de bots

Cuerpo de la solicitud

Métricas

Dimensiones

Filtros

Informes de referidos

Cuerpo de la solicitud

Métricas

Dimensiones

Filtros

Datos sin procesar

​Informes

​Informes de bots

​Informes de referidos

​Informes de bots

​Cuerpo de la solicitud

​Métricas

​Dimensiones

​Filtros

​Informes de referidos

​Cuerpo de la solicitud

​Métricas

​Dimensiones

​Filtros

​Datos sin procesar

Informes

Informes de bots

Informes de referidos

Informes de bots

Cuerpo de la solicitud

Métricas

Dimensiones

Filtros

Informes de referidos

Cuerpo de la solicitud

Métricas

Dimensiones

Filtros

Datos sin procesar