analytics

Besucherzahlen einer Website abrufen

Seitenaufrufe der Live-Website durch Personen, aufgeschlüsselt nach Seiten, Quellen, Ländern und Geräten über einen Zeitraum. Keine Credits. Die Besucherzahlen sind null, wenn der Inhaber die Besucherzählung deaktiviert hat. Nur der Inhaber kann sie im Dashboard ändern.

GET/v1/sites/{site_id}/analytics

Request

curl --request GET \
  --url 'https://api.atelier201.com/v1/sites/<site_id>/analytics' \
  --header 'Authorization: <api-key>'

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>/analytics"
headers = {
  "Authorization": "<api-key>"
}

response = requests.request("GET", url, headers=headers)
print(response.json())

const response = await fetch("https://api.atelier201.com/v1/sites/<site_id>/analytics", {
  method: "GET",
  headers: {
    "Authorization": "<api-key>"
  },
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.atelier201.com/v1/sites/<site_id>/analytics");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

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

func main() {
  req, _ := http.NewRequest("GET", "https://api.atelier201.com/v1/sites/<site_id>/analytics", nil)
  req.Header.Set("Authorization", "<api-key>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

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

var request = HttpRequest.newBuilder(URI.create("https://api.atelier201.com/v1/sites/<site_id>/analytics"))
    .header("Authorization", "<api-key>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.atelier201.com/v1/sites/<site_id>/analytics")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "<api-key>"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": {
    "period": "today",
    "from": "<string>",
    "to": "<string>",
    "visitor_counting": true,
    "totals": {
      "views": 123.45,
      "visitors": null,
      "visits": null,
      "bounce_rate": null,
      "visit_seconds": null,
      "views_per_visit": null
    },
    "previous": {
      "views": 123.45,
      "visitors": null,
      "visits": null,
      "bounce_rate": null,
      "visit_seconds": null,
      "views_per_visit": null
    },
    "series": [
      {
        "at": "<string>",
        "views": 123.45,
        "visitors": null
      }
    ],
    "pages": [
      {
        "key": "<string>",
        "views": 123.45,
        "visitors": null
      }
    ],
    "sources": [
      {
        "key": "<string>",
        "views": 123.45,
        "visitors": null
      }
    ],
    "countries": [
      {
        "key": "<string>",
        "views": 123.45,
        "visitors": null
      }
    ],
    "devices": [
      {
        "key": "<string>",
        "views": 123.45,
        "visitors": null
      }
    ],
    "browsers": [
      {
        "key": "<string>",
        "views": 123.45,
        "visitors": null
      }
    ],
    "os": [
      {
        "key": "<string>",
        "views": 123.45,
        "visitors": null
      }
    ],
    "bot_views": 123.45,
    "updated_at": null
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

Erfordert sites:read. Besucherzahlen sind null, wenn der Eigentümer die Besucherzählung deaktiviert hat. Nur der Eigentümer kann sie im Dashboard ändern.

Autorisierung

Authorizationbearerin headerrequired

Pfadparameter

site_idstringrequired

ID der Website oder ihr Slug (die Adresse vor .atelier201.page).

Query-Parameter

periodenum<string>one of: today, 7d, 30d, 90d, 12m

today, 7d, 30d, 90d oder 12m. Standard: 30d.

Antwort

application/json

Besucherzahlen einer Website abrufen

dataobjectrequired

Show child attributes

data.periodenum<string>requiredone of: today, 7d, 30d, 90d, 12m

data.fromstringrequired

Erster erfasster UTC-Tag.

data.tostringrequired

Letzter erfasster UTC-Tag: gestern, wenn die Live-Abfrage für heute nicht verfügbar war.

data.visitor_countingbooleanrequired

False, wenn der Inhaber die Besucherzählung deaktiviert hat. In diesem Fall sind die Besucherzahlen null.

data.totalsobjectrequired

Show child attributes

data.totals.viewsnumberrequired

data.totals.visitorsnumbernullrequired

data.totals.visitsnumbernullrequired

data.totals.bounce_ratenumbernullrequired

Anteil der Besuche mit nur einem Seitenaufruf, 0 bis 1.

data.totals.visit_secondsnumbernullrequired

data.totals.views_per_visitnumbernullrequired

data.previousobject | nullrequired

Dieselbe Anzahl von Tagen unmittelbar davor. Null, wenn für diesen Zeitraum keine Daten vorliegen oder für heute.

Show child attributes

data.previous.viewsnumberrequired

data.previous.visitorsnumbernullrequired

data.previous.visitsnumbernullrequired

data.previous.bounce_ratenumbernullrequired

Anteil der Besuche mit nur einem Seitenaufruf, 0 bis 1.

data.previous.visit_secondsnumbernullrequired

data.previous.views_per_visitnumbernullrequired

data.seriesobject[]required

Show child attributes

data.series.atstringrequired

data.series.viewsnumberrequired

data.series.visitorsnumbernullrequired

data.pagesobject[]required

Show child attributes

data.pages.keystringrequired

data.pages.viewsnumberrequired

data.pages.visitorsnumbernullrequired

data.sourcesobject[]required

Herkunft der Seitenaufrufe. Klicks innerhalb der Website zählen nicht als Zugriffe, daher ergeben sie zusammen weniger als die Gesamtzahl.

Show child attributes

data.sources.keystringrequired

data.sources.viewsnumberrequired

data.sources.visitorsnumbernullrequired

data.countriesobject[]required

Show child attributes

data.countries.keystringrequired

data.countries.viewsnumberrequired

data.countries.visitorsnumbernullrequired

data.devicesobject[]required

Show child attributes

data.devices.keystringrequired

data.devices.viewsnumberrequired

data.devices.visitorsnumbernullrequired

data.browsersobject[]required

Show child attributes

data.browsers.keystringrequired

data.browsers.viewsnumberrequired

data.browsers.visitorsnumbernullrequired

data.osobject[]required

Show child attributes

data.os.keystringrequired

data.os.viewsnumberrequired

data.os.visitorsnumbernullrequired

data.bot_viewsnumberrequired

Aufrufe durch Bots, getrennt von allen oben genannten Zahlen.

data.updated_atstringnullrequired

Zeitpunkt der Zusammenfassung des letzten vollständigen Tages. Vor der ersten Nacht null.

request_idstringrequired

{ "data": { "period": "today", "from": "<string>", "to": "<string>", "visitor_counting": true, "totals": { "views": 123.45, "visitors": null, "visits": null, "bounce_rate": null, "visit_seconds": null, "views_per_visit": null }, "previous": { "views": 123.45, "visitors": null, "visits": null, "bounce_rate": null, "visit_seconds": null, "views_per_visit": null }, "series": [ { "at": "<string>", "views": 123.45, "visitors": null } ], "pages": [ { "key": "<string>", "views": 123.45, "visitors": null } ], "sources": [ { "key": "<string>", "views": 123.45, "visitors": null } ], "countries": [ { "key": "<string>", "views": 123.45, "visitors": null } ], "devices": [ { "key": "<string>", "views": 123.45, "visitors": null } ], "browsers": [ { "key": "<string>", "views": 123.45, "visitors": null } ], "os": [ { "key": "<string>", "views": 123.45, "visitors": null } ], "bot_views": 123.45, "updated_at": null }, "request_id": "<string>" }

{ "error": { "type": "<string>", "code": "<string>", "message": "<string>", "param": "<string>", "docs_url": "<string>", "action_url": "<string>", "details": {} }, "request_id": "<string>" }

Besucherzahlen einer Website abrufen

Autorisierung

Pfadparameter

Query-Parameter

Antwort

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies