analytics

Consulter les chiffres de fréquentation d’un site

Vues de pages du site en ligne par des personnes, avec le détail par page, source, pays et appareil, sur une période donnée. Aucun crédit consommé. Les chiffres de fréquentation sont null lorsque le propriétaire a désactivé le comptage des visiteurs. Seul le propriétaire peut modifier ce réglage dans le tableau de bord.

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>"
}

Nécessite sites:read. Les chiffres de fréquentation sont null lorsque le propriétaire a désactivé le comptage des visiteurs. Seul le propriétaire peut modifier ce réglage dans le tableau de bord.

Autorisations

Authorizationbearerin headerrequired

Paramètres de chemin

site_idstringrequired

L’identifiant du site ou son slug (l’adresse avant .atelier201.page).

Paramètres de requête

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

today, 7d, 30d, 90d ou 12m. Valeur par défaut : 30d.

Réponse

application/json

Consulter les chiffres de fréquentation d’un site

dataobjectrequired

Show child attributes

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

data.fromstringrequired

Premier jour UTC couvert.

data.tostringrequired

Dernier jour UTC couvert : hier lorsque les données en temps réel d’aujourd’hui ne sont pas disponibles.

data.visitor_countingbooleanrequired

False lorsque le propriétaire a désactivé le comptage des visiteurs : les chiffres de fréquentation sont alors null.

data.totalsobjectrequired

Show child attributes

data.totals.viewsnumberrequired

data.totals.visitorsnumbernullrequired

data.totals.visitsnumbernullrequired

data.totals.bounce_ratenumbernullrequired

Part des visites avec une seule vue de page, de 0 à 1.

data.totals.visit_secondsnumbernullrequired

data.totals.views_per_visitnumbernullrequired

data.previousobject | nullrequired

Même nombre de jours sur la période précédente. Null s’il n’y a alors aucune donnée, ainsi que pour today.

Show child attributes

data.previous.viewsnumberrequired

data.previous.visitorsnumbernullrequired

data.previous.visitsnumbernullrequired

data.previous.bounce_ratenumbernullrequired

Part des visites avec une seule vue de page, de 0 à 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

Origine des vues. Les clics effectués sur le site ne sont pas considérés comme des arrivées : leur total est donc inférieur au nombre total de vues.

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

Vues générées par des robots, comptabilisées séparément de tous les chiffres ci-dessus.

data.updated_atstringnullrequired

Moment où les données de la dernière journée complète ont été agrégées. Null avant la première nuit.

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>" }

Consulter les chiffres de fréquentation d’un site

Autorisations

Paramètres de chemin

Paramètres de requête

Réponse

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies