Estatísticas

Visitas e cliques no WhatsApp da vitrine.

GET/v1/loja-hub/estatisticas

Parâmetros

Parâmetro	Tipo	Padrão	Descrição
`dias`	inteiro	—	Tamanho da janela, de 7 a 90. Padrão 30.

Exemplo

curl "https://api.otlshoes.com.br/v1/loja-hub/estatisticas?dias=30" \
  -H "Authorization: Bearer otl_prod_SEU_TOKEN"

curl "https://api-sandbox.otlshoes.com.br/v1/loja-hub/estatisticas?dias=30" \
  -H "Authorization: Bearer otl_sbx_SEU_TOKEN"

const resposta = await fetch('https://api.otlshoes.com.br/v1/loja-hub/estatisticas?dias=30', {
  headers: {
    Authorization: 'Bearer otl_prod_SEU_TOKEN',
  },
});

if (!resposta.ok) {
  const { erro } = await resposta.json();
  throw new Error(`${erro.codigo}: ${erro.mensagem} (${erro.requestId})`);
}
const dados = await resposta.json();

const resposta = await fetch('https://api-sandbox.otlshoes.com.br/v1/loja-hub/estatisticas?dias=30', {
  headers: {
    Authorization: 'Bearer otl_sbx_SEU_TOKEN',
  },
});

if (!resposta.ok) {
  const { erro } = await resposta.json();
  throw new Error(`${erro.codigo}: ${erro.mensagem} (${erro.requestId})`);
}
const dados = await resposta.json();

<?php
$ch = curl_init('https://api.otlshoes.com.br/v1/loja-hub/estatisticas?dias=30');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer otl_prod_SEU_TOKEN',
]);

$corpo = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new Exception($corpo['erro']['codigo'] . ': ' . $corpo['erro']['mensagem']);
}

<?php
$ch = curl_init('https://api-sandbox.otlshoes.com.br/v1/loja-hub/estatisticas?dias=30');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer otl_sbx_SEU_TOKEN',
]);

$corpo = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new Exception($corpo['erro']['codigo'] . ': ' . $corpo['erro']['mensagem']);
}

import requests

resposta = requests.get(
    "https://api.otlshoes.com.br/v1/loja-hub/estatisticas?dias=30",
    headers={
        "Authorization": "Bearer otl_prod_SEU_TOKEN",
    },
    timeout=30,
)

if not resposta.ok:
    erro = resposta.json()["erro"]
    raise RuntimeError(f'{erro["codigo"]}: {erro["mensagem"]} ({erro["requestId"]})')
dados = resposta.json()

import requests

resposta = requests.get(
    "https://api-sandbox.otlshoes.com.br/v1/loja-hub/estatisticas?dias=30",
    headers={
        "Authorization": "Bearer otl_sbx_SEU_TOKEN",
    },
    timeout=30,
)

if not resposta.ok:
    erro = resposta.json()["erro"]
    raise RuntimeError(f'{erro["codigo"]}: {erro["mensagem"]} ({erro["requestId"]})')
dados = resposta.json()

Testar agora no ambiente de testes

A chamada é feita de verdade, do seu navegador para a API de testes (https://api-sandbox.otlshoes.com.br/v1). Use um token otl_sbx_…: ele fica só nesta aba, e some ao fechá-la. Token de produção não é aceito aqui.

Token de testeGET

Resposta

{
  "dias": 30,
  "total": {
    "visitas": 1240,
    "visitantes": 870,
    "visitasAProduto": 610,
    "adicoesAoCarrinho": 95,
    "cliquesNoWhatsapp": 42,
    "conversao": 3.4
  },
  "porOrigem": [
    {
      "origem": "instagram",
      "visitas": 800,
      "visitantes": 560,
      "visitasAProduto": 400,
      "adicoesAoCarrinho": 60,
      "cliquesNoWhatsapp": 30
    },
    {
      "origem": "direto",
      "visitas": 440,
      "visitantes": 310,
      "visitasAProduto": 210,
      "adicoesAoCarrinho": 35,
      "cliquesNoWhatsapp": 12
    }
  ],
  "porDia": [
    {
      "dia": "2026-09-28",
      "visitas": 52,
      "visitantes": 40,
      "visitasAProduto": 25,
      "adicoesAoCarrinho": 4,
      "cliquesNoWhatsapp": 2
    },
    {
      "dia": "2026-09-29",
      "visitas": 61,
      "visitantes": 47,
      "visitasAProduto": 30,
      "adicoesAoCarrinho": 6,
      "cliquesNoWhatsapp": 3
    }
  ]
}

Campo	Tipo	Descrição
`visitas`	inteiro	Páginas da vitrine abertas.
`visitantes`	inteiro	Pessoas diferentes por dia. A mesma pessoa em dois dias conta duas vezes.
`visitasAProduto`	inteiro	Páginas de produto abertas.
`adicoesAoCarrinho`	inteiro	Vezes em que um item foi posto no carrinho.
`cliquesNoWhatsapp`	inteiro	Pedidos enviados pelo botão do WhatsApp.
`total.conversao`	número	% das visitas que viraram clique no WhatsApp. `null` sem visita nenhuma.
`porOrigem[].origem`	texto	De onde veio o visitante (`utm_source`): `instagram`, `direto`…
`porDia[].dia`	texto	O dia, em `AAAA-MM-DD`. Dia sem visita não aparece.

Direcionais, não contábeis

Os contadores não usam cookie nem identificam ninguém — por isso contam também quem recusa cookies. Servem para tendência e comparação, não para cobrança. Robôs de busca não entram.

Erros possíveis

HTTP	`codigo`	Quando
400	`PARAMETRO_INVALIDO`	`dias` fora de 7 a 90
403	`LOJA_HUB_NAO_LIBERADA`	A OTL ainda não liberou a loja no HUB para este parceiro
403	`ESCOPO_INSUFICIENTE`	A integração não tem `loja-hub:ler`