Tráfego de IA e de agentes

O que a IA envia realmente para o seu site: o tráfego de referência abrange as pessoas que chegam a partir de assistentes de IA e o tráfego de agentes abrange os rastreadores de IA que acedem ao seu servidor de origem.

GET`/metrics/ai_traffic`

Devolve o tráfego com origem em IA medido a partir do fornecedor de análise web ligado a um projeto (Google Analytics 4, Adobe Analytics, PostHog, Plausible ou Piano): utilizadores, sessões e conversões por dia, agrupados por origem de IA (ChatGPT, Perplexity, Gemini, Claude e outros), com totais e uma taxa de conversão. Requer o plano Scale ou superior e um fornecedor ligado; os projetos sem um devolvem ERR_AI_TRAFFIC_NOT_CONNECTED (404).

Parâmetros:

project_idobrigatório
range
from
to
granularityday|week|month
sourcerestringir a uma origem de IA

GET`/metrics/agent_traffic`

Tráfego agregado de bots de IA de um projeto, agrupado por bot ou por empresa, com granularidade diária, semanal ou mensal.

Parâmetros:

project_idobrigatório
range
from
to
bot
company
group_bybot|company
granularityday|week|month

GET`/dimensions/agent_bots`

Catálogo estático dos bots de IA que o Agent Analytics consegue identificar. Utilize-o para criar interfaces de filtragem que espelhem a nossa classificação interna (slug, nome apresentado, empresa, categoria, mapeamento de bots verificados da Cloudflare). Requer o plano Scale ou superior; a ferramenta MCP list_agent_bots está disponível no plano Scale ou superior.

Parâmetros:

project_idobrigatório

Exemplos de código

Download: OpenAPI Swagger Postman

Perguntar à IA: Abrir no ChatGPT Abrir no Claude Ver como Markdown

Linguagem

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/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áfego de IA e de agentes

GET/metrics/ai_traffic

GET/metrics/agent_traffic

GET/dimensions/agent_bots

GET`/metrics/ai_traffic`

GET`/metrics/agent_traffic`

GET`/dimensions/agent_bots`