Tráfico de IA y de agentes

Lo que la IA envía realmente a tu sitio: el tráfico de referencia cubre a las personas que llegan desde asistentes de IA y el tráfico de agentes cubre los rastreadores de IA que acceden a tu servidor de origen.

GET`/metrics/ai_traffic`

Devuelve el tráfico referido por IA medido a partir del proveedor de analítica web conectado del proyecto (Google Analytics 4, Adobe Analytics, PostHog, Plausible o Piano): usuarios, sesiones y conversiones diarios agrupados por fuente de IA (ChatGPT, Perplexity, Gemini, Claude y otras), con totales y una tasa de conversión. Requiere el plan Scale o superior y un proveedor conectado; los proyectos sin proveedor devuelven ERR_AI_TRAFFIC_NOT_CONNECTED (404).

Parámetros:

project_idobligatorio
range
from
to
granularityday|week|month
sourcerestringe a una única fuente de IA

GET`/web_analytics/schema`

Describe cómo consultar en directo el proveedor de analítica web conectado al proyecto: qué proveedor y qué propiedad, el formato de consulta nativo que acepta, los campos de nivel superior permitidos, las reglas que aplica este endpoint, un ejemplo práctico y, cuando el proveedor lo ofrece, su lista de campos obtenida en directo (todas las dimensiones y métricas de GA4, incluidas las definiciones personalizadas, los IDs de dimensiones y métricas de Adobe, los métodos de informe de Matomo, los eventos recientes de PostHog y el catálogo de Plausible). Se guarda en caché durante una hora. A diferencia de /metrics/ai_traffic, que devuelve las cifras de tráfico referido por IA que la sincronización de Tráfico de IA ya ha almacenado, estos endpoints leen directamente del proveedor. Los proyectos sin un proveedor conectado devuelven ERR_WEB_ANALYTICS_NOT_CONNECTED (404). Requiere el plan Growth o superior. MCP: get_web_analytics_schema.

Parámetros:

project_idobligatorio

POST`/web_analytics/query`

Ejecuta en directo una consulta de solo lectura contra el proveedor de analítica web conectado al proyecto y devuelve columnas y filas. Escribe la consulta en el formato propio del proveedor: un cuerpo de GA4 Data API runReport, una solicitud de informe de Adobe Analytics o Customer Journey Analytics, parámetros de Matomo Reporting API (solo métodos get), PostHog HogQL, una consulta de Plausible Stats API v2 o un cuerpo de Piano getData. Siempre se usan la propiedad, el sitio, el grupo de informes o el proyecto conectados, y se ignora cualquier campo de propiedad incluido en la consulta. Por defecto se devuelven 100 filas, con un máximo de 5000; las consultas idénticas se responden desde una caché de 10 minutos (cached: true). Una consulta que el proveedor rechaza devuelve ERR_WEB_ANALYTICS_INVALID_QUERY (422) con el propio mensaje de validación del proveedor. Cada consulta que no sale de la caché consume la cuota de API del proveedor que comparte la sincronización de Tráfico de IA, y un proyecto admite 20 consultas sin caché por minuto (ERR_WEB_ANALYTICS_UPSTREAM, 503, con Retry-After). Requiere el plan Growth o superior; no hace falta una clave con permisos de escritura. MCP: query_web_analytics.

Cuerpo (JSON): project_id (obligatorio), query (obligatorio): el objeto de consulta nativo o, para PostHog, la cadena HogQL o {"query": "SELECT ..."}.

GET`/metrics/agent_traffic`

Tráfico de bots de IA agregado para un proyecto, agrupado por bot o por empresa, con granularidad diaria, semanal o mensual.

Parámetros:

project_idobligatorio
range
from
to
bot
company
group_bybot|company
granularityday|week|month

GET`/dimensions/agent_bots`

Catálogo estático de bots de IA que Agent Analytics puede identificar. Úsalo para mostrar las interfaces de filtrado que reflejan nuestra clasificación interna (slug, nombre para mostrar, empresa, categoría y correspondencia con la clasificación de bots verificados de Cloudflare). Requiere el plan Scale o superior; la herramienta MCP list_agent_bots está disponible en el plan Scale o superior.

Parámetros:

project_idobligatorio

Ejemplos de código

Download: OpenAPI Swagger Postman

Preguntar a la IA: Abrir en ChatGPT Abrir en Claude Ver como Markdown

Idioma

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/metrics/ai_traffic?project_id=PROJECT_ID&range=30&granularity=day"

const response = await fetch("https://api.llmpulse.ai/api/v1/metrics/ai_traffic?project_id=PROJECT_ID&range=30&granularity=day", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/metrics/ai_traffic?project_id=PROJECT_ID&range=30&granularity=day",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/metrics/ai_traffic?project_id=PROJECT_ID&range=30&granularity=day",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/metrics/ai_traffic?project_id=PROJECT_ID&range=30&granularity=day", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/metrics/ai_traffic?project_id=PROJECT_ID&range=30&granularity=day', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/metrics/ai_traffic?project_id=PROJECT_ID&range=30&granularity=day"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/web_analytics/schema?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/web_analytics/schema?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/web_analytics/schema?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/web_analytics/schema?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/web_analytics/schema?project_id=PROJECT_ID", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/web_analytics/schema?project_id=PROJECT_ID', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/web_analytics/schema?project_id=PROJECT_ID"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","query":{"dateRanges":[{"startDate":"28daysAgo","endDate":"yesterday"}],"dimensions":[{"name":"sessionDefaultChannelGroup"}],"metrics":[{"name":"sessions"},{"name":"keyEvents"}],"limit":20}}' \
  "https://api.llmpulse.ai/api/v1/web_analytics/query"

const response = await fetch("https://api.llmpulse.ai/api/v1/web_analytics/query", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","query":{"dateRanges":[{"startDate":"28daysAgo","endDate":"yesterday"}],"dimensions":[{"name":"sessionDefaultChannelGroup"}],"metrics":[{"name":"sessions"},{"name":"keyEvents"}],"limit":20}})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/web_analytics/query",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id":"PROJECT_ID","query":{"dateRanges":[{"startDate":"28daysAgo","endDate":"yesterday"}],"dimensions":[{"name":"sessionDefaultChannelGroup"}],"metrics":[{"name":"sessions"},{"name":"keyEvents"}],"limit":20}}
)
data = response.json()

require 'httparty'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/web_analytics/query",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" },
  body: {"project_id":"PROJECT_ID","query":{"dateRanges":[{"startDate":"28daysAgo","endDate":"yesterday"}],"dimensions":[{"name":"sessionDefaultChannelGroup"}],"metrics":[{"name":"sessions"},{"name":"keyEvents"}],"limit":20}}
)
data = response.parsed_response

req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/web_analytics/query", strings.NewReader(`{"project_id":"PROJECT_ID","query":{"dateRanges":[{"startDate":"28daysAgo","endDate":"yesterday"}],"dimensions":[{"name":"sessionDefaultChannelGroup"}],"metrics":[{"name":"sessions"},{"name":"keyEvents"}],"limit":20}}`))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://api.llmpulse.ai/api/v1/web_analytics/query', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => {"project_id":"PROJECT_ID","query":{"dateRanges":[{"startDate":"28daysAgo","endDate":"yesterday"}],"dimensions":[{"name":"sessionDefaultChannelGroup"}],"metrics":[{"name":"sessions"},{"name":"keyEvents"}],"limit":20}}
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/web_analytics/query"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"query\":{\"dateRanges\":[{\"startDate\":\"28daysAgo\",\"endDate\":\"yesterday\"}],\"dimensions\":[{\"name\":\"sessionDefaultChannelGroup\"}],\"metrics\":[{\"name\":\"sessions\"},{\"name\":\"keyEvents\"}],\"limit\":20}}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/metrics/agent_traffic?project_id=PROJECT_ID&range=30&group_by=bot&granularity=day"

const response = await fetch("https://api.llmpulse.ai/api/v1/metrics/agent_traffic?project_id=PROJECT_ID&range=30&group_by=bot&granularity=day", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/metrics/agent_traffic?project_id=PROJECT_ID&range=30&group_by=bot&granularity=day",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/metrics/agent_traffic?project_id=PROJECT_ID&range=30&group_by=bot&granularity=day",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/metrics/agent_traffic?project_id=PROJECT_ID&range=30&group_by=bot&granularity=day", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/metrics/agent_traffic?project_id=PROJECT_ID&range=30&group_by=bot&granularity=day', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/metrics/agent_traffic?project_id=PROJECT_ID&range=30&group_by=bot&granularity=day"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/dimensions/agent_bots?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/dimensions/agent_bots?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/dimensions/agent_bots?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/dimensions/agent_bots?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/dimensions/agent_bots?project_id=PROJECT_ID", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/dimensions/agent_bots?project_id=PROJECT_ID', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/dimensions/agent_bots?project_id=PROJECT_ID"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Tráfico de IA y de agentes

GET/metrics/ai_traffic

GET/web_analytics/schema

POST/web_analytics/query

GET/metrics/agent_traffic

GET/dimensions/agent_bots

GET`/metrics/ai_traffic`

GET`/web_analytics/schema`

POST`/web_analytics/query`

GET`/metrics/agent_traffic`

GET`/dimensions/agent_bots`