KI- und Agenten-Traffic

Was KI tatsächlich auf Ihre Website bringt: Der Verweis-Traffic umfasst Menschen, die über KI-Assistenten zu Ihnen kommen, und der Agenten-Traffic die KI-Crawler, die auf Ihren Ursprungsserver zugreifen.

GET`/metrics/ai_traffic`

Liefert den KI-Traffic, den der verbundene Webanalyse-Anbieter des Projekts (Google Analytics 4, Adobe Analytics, PostHog, Plausible oder Piano) misst: Nutzer, Sitzungen und Conversions pro Tag, gruppiert nach KI-Quelle (ChatGPT, Perplexity, Gemini, Claude und weitere), mit Summen und einer Conversion-Rate. Verfügbar ab Tarif Scale, sofern ein Anbieter verbunden ist. Für Projekte ohne verbundenen Anbieter wird ERR_AI_TRAFFIC_NOT_CONNECTED (404) zurückgegeben.

Parameter:

project_iderforderlich
range
from
to
granularityday|week|month
sourceEinschränkung auf eine KI-Quelle

GET`/web_analytics/schema`

Beschreibt, wie Sie den mit dem Projekt verbundenen Webanalyse-Anbieter live abfragen: Anbieter und Property, das native Abfrageformat des Anbieters, die zulässigen Felder der obersten Ebene, die Regeln, die dieser Endpunkt durchsetzt, ein vollständiges Beispiel und, sofern der Anbieter sie bereitstellt, seine aktuelle Feldliste (alle Dimensionen und Messwerte von GA4 einschließlich benutzerdefinierter Definitionen, die IDs der Dimensionen und Messwerte von Adobe, die Berichtsmethoden von Matomo, die neuesten Ereignisse von PostHog, den Katalog von Plausible). Wird eine Stunde lang zwischengespeichert. Anders als der Endpunkt /metrics/ai_traffic, der die bei der Synchronisierung von KI-Traffic bereits gespeicherten Zahlen zu Zugriffen über KI-Assistenten liefert, lesen diese Endpunkte direkt beim Anbieter. Für Projekte ohne verbundenen Anbieter wird ERR_WEB_ANALYTICS_NOT_CONNECTED (404) zurückgegeben. Verfügbar ab Tarif Growth. MCP: get_web_analytics_schema.

Parameter:

project_iderforderlich

POST`/web_analytics/query`

Fragt den mit dem Projekt verbundenen Webanalyse-Anbieter live und nur lesend ab und liefert Spalten und Zeilen. Formulieren Sie die Abfrage im nativen Format des Anbieters: als runReport-Anfragetext der GA4 Data API, als Berichtsanfrage für Adobe Analytics oder Customer Journey Analytics, als Parameter der Matomo Reporting API (nur get-Methoden), als HogQL für PostHog, als Abfrage für die Plausible Stats API v2 oder als getData-Anfragetext für Piano. Abgefragt wird immer die verbundene Ressource (Property, Website, Report Suite oder Projekt); eine Angabe der Property in der Abfrage wird ignoriert. Standardmäßig werden 100 Zeilen geliefert, höchstens 5.000; identische Abfragen werden 10 Minuten lang aus dem Cache beantwortet (cached: true). Lehnt der Anbieter eine Abfrage ab, wird ERR_WEB_ANALYTICS_INVALID_QUERY (422) mit der Validierungsmeldung des Anbieters zurückgegeben. Jede nicht zwischengespeicherte Abfrage verbraucht API-Kontingent des Anbieters, das auch die Synchronisierung von KI-Traffic nutzt, und je Projekt sind 20 nicht zwischengespeicherte Abfragen pro Minute erlaubt (ERR_WEB_ANALYTICS_UPSTREAM, 503, mit Retry-After). Verfügbar ab Tarif Growth; ein API-Schlüssel mit Schreibzugriff ist nicht erforderlich. MCP: query_web_analytics.

JSON-Anfragetext: project_id (erforderlich), query (erforderlich): das native Abfrageobjekt oder, bei PostHog, die HogQL-Abfrage als Zeichenfolge oder {"query": "SELECT ..."}.

GET`/metrics/agent_traffic`

Aggregierter Traffic von KI-Bots für ein Projekt, gruppiert nach Bot oder Unternehmen, wahlweise pro Tag, Woche oder Monat.

Parameter:

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

GET`/dimensions/agent_bots`

Statischer Katalog der KI-Bots, die Agent Analytics erkennen kann. Nutzen Sie ihn, um Filteroberflächen darzustellen, die unsere interne Klassifizierung abbilden (Slug, Anzeigename, Unternehmen, Kategorie, Zuordnung zu den verifizierten Bots von Cloudflare). Verfügbar ab Tarif Scale, ebenso das MCP-Tool list_agent_bots.

Parameter:

project_iderforderlich, wird aber ignoriert: Der Katalog ist für alle Projekte gleich

Codebeispiele

Download: OpenAPI Swagger Postman

KI fragen: In ChatGPT öffnen In Claude öffnen Als Markdown anzeigen

Sprache

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

package main

import "net/http"

func main() {
	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, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	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);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        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

package main

import "net/http"

func main() {
	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, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	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);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        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'
require 'json'

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

package main

import (
	"net/http"
	"strings"
)

func main() {
	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, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	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);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        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

package main

import "net/http"

func main() {
	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, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	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);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        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

package main

import "net/http"

func main() {
	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, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	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);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        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());
    }
}

KI- und Agenten-Traffic

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`