Acessos ao site por recorte

Request

Como o site é acessado no período. O recorte é escolhido por cut.

O campo unit da resposta diz o que os números contam e muda por recorte: pageviews na maioria, devices em technology e ips em geography (um escritório inteiro pode aparecer como um IP só).

sources usa utm_source; referrers agrupa a origem real por domínio e por isso enxerga o tráfego que chega sem UTM.

attribution é o único recorte que conta EMPRESAS, não tráfego. Ele liga a origem à identificação e responde "de onde vêm os leads" — a pergunta de quem decide verba, porque separa o canal que traz volume do canal que traz empresa. Devolve byOrigin (domínio do referrer, com (direto) para quem chega sem referrer) e byCampaign (utm_campaign, que só enxerga link tagueado). Uma empresa conta uma vez por origem, mesmo com várias visitas.

Security

ApiKeyAuth

Path

site_idintegerrequired

ID do site (vem de /reveal/sites/).

Example:13

Query

startDatestring, (date)

Início do período, YYYY-MM-DD (inclusive). Sem startDate/endDate, assume-se os últimos 30 dias. O máximo é 90 dias por chamada.

Example:startDate=2026-07-01

endDatestring, (date)

Fim do período, YYYY-MM-DD (inclusive). Padrão, hoje.

Example:endDate=2026-07-31

cutstring

Recorte da análise (padrão pages).

Default:"pages"

Enum:"pages""sources""campaigns""referrers""technology""geography""hours""attribution"

topinteger

Quantos itens trazer nos recortes de ranking (máx. 100).

Default:10

curl -i -X GET \
  'https://docs.datastone.com.br/_mock/api/reveal/sites/13/traffic/?startDate=2026-07-01&endDate=2026-07-31&cut=pages&top=10' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Acessos ao site

Bodyapplication/json

siteobject

periodobject

cutstring

Example:"referrers"

unitstring

Enum:"pageviews""devices""ips""companies"

dataArray of objects or object

One of:

Lista nos recortes de ranking; objeto com sublistas em technology (deviceTypes/browsers/operatingSystems) e geography (countries/regions/cities). Em hours, cada item tem weekday (1=segunda … 7=domingo), hour e pageviews. Em attribution, objeto com byOrigin e byCampaign, cada item com companies e pageviews.

Array of objects

Response

{
  "site": {},
  "period": {},
  "cut": "referrers",
  "unit": "pageviews",
  "data": [
    {}
  ]
}