Reports

Visits

View as Markdown Raw markdown in a new tab Open in ChatGPT Ask questions about this page Open in Claude Ask questions about this page

GET / v1 / reports / visits

Visits per day or month, with one number per product.

A browser session on the product page and its checkout counts as one visit, at most once per 30 minutes.
from and to are both included. Days are UTC.
Visits of the account owner and products that are not live are not counted.
Landing pages and the shop page have no visit counter.
There are no traffic sources and no unique visitors yet.

For orders and money, call GET /v1/orders or GET /v1/reports/revenue.

Reads only MCP tool get_visits

curl "https://api.tentary.com/v1/reports/visits?from=2026-10-24&to=2026-10-26" \
  -H "Authorization: Bearer $TENTARY_API_KEY"

const response = await fetch("https://api.tentary.com/v1/reports/visits?from=2026-10-24&to=2026-10-26", {
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.tentary.com/v1/reports/visits",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    params={
        "from": "2026-10-24",
        "to": "2026-10-26",
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/reports/visits?from=2026-10-24&to=2026-10-26');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "from": "2026-10-24",
  "to": "2026-10-26",
  "group_by": "day",
  "product_id": null,
  "visits": 133,
  "periods": [
    {
      "period": "2026-10-24",
      "visits": 52
    },
    {
      "period": "2026-10-25",
      "visits": 36
    },
    {
      "period": "2026-10-26",
      "visits": 45
    }
  ],
  "products": [
    {
      "product_id": 102,
      "title": "Morning Yoga in 30 Days",
      "visits": 98
    },
    {
      "product_id": 101,
      "title": "Yoga Basics E-Book",
      "visits": 35
    }
  ],
  "more_products": false,
  "admin_url": "https://app.tentary.com/reports"
}

Authorization

Authorization string header required

Bearer tnt_… · A personal API key (tnt_...). Create it in the Tentary app on the page AI & API. Introduction

Query parameters

from string

First day (UTC), like 2026-01-01. Default: 29 days before to.

pattern ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ Example: "2026-10-24"
to string

Last day (UTC). Default today. 731 days at most.

pattern ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ Example: "2026-10-26"
group_by string

day (default, 92 days at most) or month.

Allowed values: daymonth
product_id integer

Only this product (id from list_products).

min 1

Response

Fields of the answer with status 200. Errors always have the same format, see Errors.

from string<date>

Like 2026-01-31.
to string<date>

Like 2026-01-31.
group_by string

How the periods are grouped.

Allowed values: daymonth
product_id integer can be null

The product ID.
visits integer

All visits in the period.
periods array of object

Every period, also without visits.
Show 2 fields Hide fields
- period string
  
  Like 2026-01-31 or 2026-01.
- visits integer
  
  Number of visits.
products array of object

Most visits first.
Show 3 fields Hide fields
- product_id integer
  
  The product ID.
- title string can be null
  
  The title.
- visits integer
  
  Number of visits.
more_products boolean

true = more products than this list.
admin_url string<uri>

The page in the Tentary app.