Traffic-Analytics einer Website abrufen

GET

apps

{app_id}

network

analytics

Traffic-Analytics einer Website abrufen

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/analytics \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.squarecloud.app/v2/apps/{app_id}/network/analytics"

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/analytics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.squarecloud.app/v2/apps/{app_id}/network/analytics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.squarecloud.app/v2/apps/{app_id}/network/analytics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/analytics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "response": {
    "visits": [
      { "visits": 1024, "requests": 1247, "bytes": 8421000, "date": "2026-05-21T10:00:00Z" }
    ],
    "countries": [
      { "type": "BR", "visits": 612, "requests": 743, "bytes": 5012000, "date": "2026-05-21T10:00:00Z" }
    ],
    "devices": [
      { "type": "desktop", "visits": 820, "requests": 998, "bytes": 6700000, "date": "2026-05-21T10:00:00Z" }
    ],
    "os": [
      { "type": "Windows", "visits": 540, "requests": 651, "bytes": 4400000, "date": "2026-05-21T10:00:00Z" }
    ],
    "browsers": [
      { "type": "Chrome", "visits": 720, "requests": 870, "bytes": 5800000, "date": "2026-05-21T10:00:00Z" }
    ],
    "protocols": [
      { "type": "HTTP/2", "visits": 900, "requests": 1100, "bytes": 7400000, "date": "2026-05-21T10:00:00Z" }
    ],
    "methods": [
      { "type": "GET", "visits": 850, "requests": 1020, "bytes": 6900000, "date": "2026-05-21T10:00:00Z" }
    ],
    "paths": [
      { "type": "/", "visits": 410, "requests": 498, "bytes": 3320000, "date": "2026-05-21T10:00:00Z" }
    ],
    "referers": [
      { "type": "Direct", "visits": 380, "requests": 462, "bytes": 3100000, "date": "2026-05-21T10:00:00Z" }
    ],
    "providers": [
      { "type": "GOOGLE (15169)", "visits": 210, "requests": 254, "bytes": 1700000, "date": "2026-05-21T10:00:00Z" }
    ],
    "ips": [
      { "type": "203.0.113.45", "visits": 40, "requests": 3120, "bytes": 2100000 }
    ],
    "status_codes": [
      { "type": "200", "visits": 950, "requests": 1180, "bytes": 8100000 }
    ],
    "bots": [
      { "type": "Search Engine Crawler", "visits": 0, "requests": 84, "bytes": 410000 }
    ],
    "content_types": [
      { "type": "json", "visits": 310, "requests": 720, "bytes": 4200000 }
    ]
  }
}

string

erforderlich

Der API-Schlüssel für dein Konto. Du findest ihn in deinen Kontoeinstellungen.

Erfordert einen API-Schlüssel mit dem Scope apps:read. Analytics aggregiert den Cloudflare-Edge-Traffic für die Standarddomain squareweb.app der Anwendung sowie jede angebundene Custom Domain: Anfragezahlen, Bandbreite, Besucherzahlen sowie Aufschlüsselungen nach Land, Gerät, Betriebssystem, Browser, Protokoll, Methode, Pfad, Referer und Client-Netzwerk. Nutze es, um Traffic-Dashboards aufzubauen oder ungewöhnliche Muster zu erkennen, ohne Rohdaten der Anfrageprotokolle abzurufen. Ergebnisse werden in 5-Minuten-Fenstern zwischengespeichert, wiederholtes Abfragen desselben Zeitfensters ist also günstig. Cache-Misses teilen sich ein gemeinsames Limit von 20 Anfragen pro 60 Sekunden pro Eigentümer der Anwendung, über die Endpunkte Analytics, Errors, Logs und Performance hinweg. Zwischengespeicherte Antworten zählen nicht. In Zeiten hoher Last auf der gesamten Plattform kann der Endpunkt stattdessen die neuesten zwischengespeicherten Daten für das angeforderte Zeitfenster zurückgeben. Der maximale Rückblickzeitraum beträgt 7 Tage, und der effektive Start wird auf das Erstellungsdatum der Anwendung begrenzt. Im Gegensatz zu Netzwerk-Logs und Netzwerk-Performance ist dieser Endpoint in jedem Tarif verfügbar, nicht nur in Pro und Enterprise. Für fehlerfokussierten statt allgemeinen Traffic siehe Netzwerkfehler. Um zwischengespeicherte Edge-Antworten nach einem Deploy zu leeren, siehe Cache leeren.

Parameter

string

erforderlich

Die ID der Anwendung. Du findest sie in der URL des Dashboards deiner Anwendung.

string

erforderlich

ISO-8601-Startzeitstempel für den Analysezeitraum. Der maximale Aufbewahrungszeitraum beträgt 7 Tage; der Startwert wird auf das Erstellungsdatum der Anwendung begrenzt.

string

erforderlich

ISO-8601-Endzeitstempel. Muss nach start liegen.

Drilldown-Filter

Optionale Filter, die jede Aufschlüsselung auf den passenden Traffic einschränken. Gib den exakten type-Wert zurück, der von der entsprechenden Aufschlüsselung in einer vorherigen Antwort geliefert wurde. Filter werden kombiniert (AND).

string

Ein einzelnes Client-Land (2-stelliger Code), wie in der countries-Aufschlüsselung geliefert.

string

Eine einzelne Client-IP (exakter IPv4-/IPv6-Treffer), wie in der ips-Aufschlüsselung geliefert.

string

Anfragepfade, die mit diesem Präfix beginnen (z. B. deckt /api auch /api/* ab). Maximal 256 Zeichen.

string

Ein einzelner Edge-Antwortstatuscode (3 Ziffern), wie in der status_codes-Aufschlüsselung geliefert.

string

Ein einzelnes Client-Betriebssystem, wie in der os-Aufschlüsselung geliefert.

string

Ein einzelner Client-Browser, wie in der browsers-Aufschlüsselung geliefert.

string

Ein einzelnes HTTP-Protokoll, wie in der protocols-Aufschlüsselung geliefert.

string

Ein einzelner Referer-Host, wie in der referers-Aufschlüsselung geliefert (Direct = kein Referer).

string

Ein einzelnes Client-Netzwerk, mit genau dem type-Wert, den die providers-Aufschlüsselung liefert, zum Beispiel GOOGLE (15169). Eine reine ASN-Nummer oder SQUARE-CLOUD-PLATFORM funktionieren ebenfalls. Jeder andere Wert antwortet mit INVALID_FILTER.

string

Ein einzelner Antwort-Content-Type, wie in der content_types-Aufschlüsselung geliefert (Unknown = nicht klassifiziert).

string

Eine einzelne Kategorie verifizierter Bots, wie in der bots-Aufschlüsselung geliefert (Unverified = regulärer Nicht-Bot-Traffic).

Antwort

Diese Route kann eine Antwort in komprimiertem Format senden und so die Datenübertragung optimieren.

string

Gibt an, ob der Aufruf erfolgreich war: success, wenn ja, error, wenn nicht.

object

Jede Aufschlüsselung ist ein Array von Buckets. type identifiziert die Dimension, visits sind eindeutige Besucher, requests ist die Anzahl der Anfragen, bytes sind die ausgelieferten Antwort-Bytes und date ist der Beginn des 15-Minuten-Fensters. Die Aufschlüsselungen ips, status_codes, bots und content_types sind Fenstersummen (Top-N über das gesamte Fenster) und enthalten kein date-Feld. Liefert ein leeres Objekt ({}), wenn das angeforderte Fenster vor dem Erstellungsdatum der Anwendung beginnt.

{
  "status": "success",
  "response": {
    "visits": [
      { "visits": 1024, "requests": 1247, "bytes": 8421000, "date": "2026-05-21T10:00:00Z" }
    ],
    "countries": [
      { "type": "BR", "visits": 612, "requests": 743, "bytes": 5012000, "date": "2026-05-21T10:00:00Z" }
    ],
    "devices": [
      { "type": "desktop", "visits": 820, "requests": 998, "bytes": 6700000, "date": "2026-05-21T10:00:00Z" }
    ],
    "os": [
      { "type": "Windows", "visits": 540, "requests": 651, "bytes": 4400000, "date": "2026-05-21T10:00:00Z" }
    ],
    "browsers": [
      { "type": "Chrome", "visits": 720, "requests": 870, "bytes": 5800000, "date": "2026-05-21T10:00:00Z" }
    ],
    "protocols": [
      { "type": "HTTP/2", "visits": 900, "requests": 1100, "bytes": 7400000, "date": "2026-05-21T10:00:00Z" }
    ],
    "methods": [
      { "type": "GET", "visits": 850, "requests": 1020, "bytes": 6900000, "date": "2026-05-21T10:00:00Z" }
    ],
    "paths": [
      { "type": "/", "visits": 410, "requests": 498, "bytes": 3320000, "date": "2026-05-21T10:00:00Z" }
    ],
    "referers": [
      { "type": "Direct", "visits": 380, "requests": 462, "bytes": 3100000, "date": "2026-05-21T10:00:00Z" }
    ],
    "providers": [
      { "type": "GOOGLE (15169)", "visits": 210, "requests": 254, "bytes": 1700000, "date": "2026-05-21T10:00:00Z" }
    ],
    "ips": [
      { "type": "203.0.113.45", "visits": 40, "requests": 3120, "bytes": 2100000 }
    ],
    "status_codes": [
      { "type": "200", "visits": 950, "requests": 1180, "bytes": 8100000 }
    ],
    "bots": [
      { "type": "Search Engine Crawler", "visits": 0, "requests": 84, "bytes": 410000 }
    ],
    "content_types": [
      { "type": "json", "visits": 310, "requests": 720, "bytes": 4200000 }
    ]
  }
}

Häufige Fehler

Code	HTTP	Bedeutung
`INVALID_TIME_RANGE`	400	`start`/`end` fehlen, sind fehlerhaft formatiert oder kehren den Zeitraum um.
`INVALID_FILTER`	400	Ein Drilldown-Filter entspricht nicht dem erwarteten Format.
`RATE_LIMITED`	429	Das gemeinsame Limit für Cache-Misses wurde erreicht. Warte und versuche es erneut.
`UNABLE_TO_FETCH_ANALYTICS`	500	Die Analytics-Daten konnten nicht vom Edge-Provider abgerufen werden.
`ANALYTICS_BUSY`	503	Die Edge-Analytics sind vorübergehend ausgelastet. Versuche es in einer Minute erneut.

Siehe auch

CLI: squarecloud app network analytics
SDKs: api.apps.network.analytics() (JavaScript), client.apps.network.analytics() (Python), c.Apps.Network.Analytics() (Go)

Traffic-Analytics einer Website abrufen

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/analytics \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.squarecloud.app/v2/apps/{app_id}/network/analytics"

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/analytics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.squarecloud.app/v2/apps/{app_id}/network/analytics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.squarecloud.app/v2/apps/{app_id}/network/analytics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/analytics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "response": {
    "visits": [
      { "visits": 1024, "requests": 1247, "bytes": 8421000, "date": "2026-05-21T10:00:00Z" }
    ],
    "countries": [
      { "type": "BR", "visits": 612, "requests": 743, "bytes": 5012000, "date": "2026-05-21T10:00:00Z" }
    ],
    "devices": [
      { "type": "desktop", "visits": 820, "requests": 998, "bytes": 6700000, "date": "2026-05-21T10:00:00Z" }
    ],
    "os": [
      { "type": "Windows", "visits": 540, "requests": 651, "bytes": 4400000, "date": "2026-05-21T10:00:00Z" }
    ],
    "browsers": [
      { "type": "Chrome", "visits": 720, "requests": 870, "bytes": 5800000, "date": "2026-05-21T10:00:00Z" }
    ],
    "protocols": [
      { "type": "HTTP/2", "visits": 900, "requests": 1100, "bytes": 7400000, "date": "2026-05-21T10:00:00Z" }
    ],
    "methods": [
      { "type": "GET", "visits": 850, "requests": 1020, "bytes": 6900000, "date": "2026-05-21T10:00:00Z" }
    ],
    "paths": [
      { "type": "/", "visits": 410, "requests": 498, "bytes": 3320000, "date": "2026-05-21T10:00:00Z" }
    ],
    "referers": [
      { "type": "Direct", "visits": 380, "requests": 462, "bytes": 3100000, "date": "2026-05-21T10:00:00Z" }
    ],
    "providers": [
      { "type": "GOOGLE (15169)", "visits": 210, "requests": 254, "bytes": 1700000, "date": "2026-05-21T10:00:00Z" }
    ],
    "ips": [
      { "type": "203.0.113.45", "visits": 40, "requests": 3120, "bytes": 2100000 }
    ],
    "status_codes": [
      { "type": "200", "visits": 950, "requests": 1180, "bytes": 8100000 }
    ],
    "bots": [
      { "type": "Search Engine Crawler", "visits": 0, "requests": 84, "bytes": 410000 }
    ],
    "content_types": [
      { "type": "json", "visits": 310, "requests": 720, "bytes": 4200000 }
    ]
  }
}

Erste Schritte

Konto

Anwendungen

Datenbanken

Workspaces

KI

Traffic-Analytics einer Website abrufen

Parameter

Drilldown-Filter

Antwort

Häufige Fehler

Siehe auch

​Parameter

​Drilldown-Filter

​Antwort

​Häufige Fehler

​Siehe auch

Parameter

Drilldown-Filter

Antwort

Häufige Fehler

Siehe auch