analytics

Consultar las visitas de un sitio

Visualizaciones de páginas del sitio publicado por personas, desglosadas por páginas, fuentes, países y dispositivos, durante un periodo. Sin créditos. Las cifras de visitantes son null si el propietario ha desactivado el recuento de visitantes. Solo el propietario puede cambiarlo en el panel de control.

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

Requiere sites:read. Las cifras de visitantes son null si el propietario ha desactivado el recuento de visitas. Solo el propietario puede cambiar esta opción en el panel.

Autorizaciones

Authorizationbearerin headerrequired

Parámetros de ruta

site_idstringrequired

El ID del sitio o su slug (la dirección antes de .atelier201.page).

Parámetros de consulta

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

today, 7d, 30d, 90d o 12m. Valor predeterminado: 30d.

Respuesta

application/json

Consulta las visitas de un sitio

dataobjectrequired

Show child attributes

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

data.fromstringrequired

Primer día UTC incluido.

data.tostringrequired

Último día UTC incluido: ayer si no estaban disponibles los datos en tiempo real de hoy.

data.visitor_countingbooleanrequired

False si el propietario ha desactivado el recuento de visitantes. En ese caso, las cifras de visitantes son null.

data.totalsobjectrequired

Show child attributes

data.totals.viewsnumberrequired

data.totals.visitorsnumbernullrequired

data.totals.visitsnumbernullrequired

data.totals.bounce_ratenumbernullrequired

Proporción de visitas con una sola visualización de página, de 0 a 1.

data.totals.visit_secondsnumbernullrequired

data.totals.views_per_visitnumbernullrequired

data.previousobject | nullrequired

El mismo número de días inmediatamente anterior. Null si no hay datos de ese periodo y para hoy.

Show child attributes

data.previous.viewsnumberrequired

data.previous.visitorsnumbernullrequired

data.previous.visitsnumbernullrequired

data.previous.bounce_ratenumbernullrequired

Proporción de visitas con una sola visualización 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

Procedencia de las visualizaciones. Los clics dentro del sitio no cuentan como visitas, por lo que el total es inferior al de visualizaciones.

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

Visualizaciones de bots, separadas de todas las cifras anteriores.

data.updated_atstringnullrequired

Momento en que se consolidaron los datos del último día completo. Null antes de la primera consolidación nocturna.

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 las visitas de un sitio

Autorizaciones

Parámetros de ruta

Parámetros de consulta

Respuesta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies