analytics

Consultar os números de visitantes de um site

Visualizações de páginas do site publicado feitas por pessoas, com páginas, origens, países e dispositivos, ao longo de um período. Sem créditos. Os dados de visitantes são null quando o proprietário desativa a contagem de visitantes. Somente o proprietário pode alterar essa opção no painel.

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

Requer sites:read. Os dados de visitantes são null quando o proprietário desativa a contagem de visitantes. Só o proprietário pode alterar essa configuração no painel.

Autorizações

Authorizationbearerin headerrequired

Parâmetros de caminho

site_idstringrequired

O id do site ou seu slug (o endereço antes de .atelier201.page).

Parâmetros de consulta

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

today, 7d, 30d, 90d ou 12m. Padrão: 30d.

Resposta

application/json

Consulte os números de visitantes de um site

dataobjectrequired

Show child attributes

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

data.fromstringrequired

Primeiro dia UTC incluído.

data.tostringrequired

Último dia UTC incluído: ontem quando os dados de hoje não estavam disponíveis.

data.visitor_countingbooleanrequired

False quando o proprietário desativa a contagem de visitantes. Nesse caso, os dados de visitantes são null.

data.totalsobjectrequired

Show child attributes

data.totals.viewsnumberrequired

data.totals.visitorsnumbernullrequired

data.totals.visitsnumbernullrequired

data.totals.bounce_ratenumbernullrequired

Proporção de visitas com uma única visualização de página, de 0 a 1.

data.totals.visit_secondsnumbernullrequired

data.totals.views_per_visitnumbernullrequired

data.previousobject | nullrequired

O mesmo número de dias imediatamente anterior. Null quando não há dados para esse período e para hoje.

Show child attributes

data.previous.viewsnumberrequired

data.previous.visitorsnumbernullrequired

data.previous.visitsnumbernullrequired

data.previous.bounce_ratenumbernullrequired

Proporção de visitas com uma única visualização de página, de 0 a 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

Origens das visualizações. Cliques dentro do site não são considerados acessos, então o total é menor que o total de visualizações.

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

Visualizações de bots, mantidas separadas de todos os números acima.

data.updated_atstringnullrequired

Quando os dados do último dia completo foram consolidados. Null antes da primeira consolidação noturna.

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

Consultar os números de visitantes de um site

Autorizações

Parâmetros de caminho

Parâmetros de consulta

Resposta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies