Timeseries

GET /api/v1/timeseries — Daily visitors, pageviews, revenue, and spend over time.

Endpoint

GET /api/v1/timeseries

Returns daily data points for visitors, pageviews, bounces, cash revenue, and ad spend across the requested date range. Use this endpoint to power line charts, bar charts, and trend comparisons in your dashboards.

Scope: analytics:read

Parameters

Parameter	Type	Required	Description
`date_from`	string	Yes	Start date in `YYYY-MM-DD` format.
`date_to`	string	Yes	End date in `YYYY-MM-DD` format.
`filter[dimension]`	string	No	Filter results by a dimension. See Breakdowns for syntax.

Request

cURL

curl -H "Authorization: Bearer atb_live_YOUR_KEY" \
  "https://www.atribu.app/api/v1/timeseries?date_from=2026-03-20&date_to=2026-03-25"

JavaScript

const res = await fetch(
  "https://www.atribu.app/api/v1/timeseries?date_from=2026-03-20&date_to=2026-03-25",
  { headers: { Authorization: "Bearer atb_live_YOUR_KEY" } }
);
const { data, meta } = await res.json();

Python

import requests

res = requests.get(
    "https://www.atribu.app/api/v1/timeseries",
    headers={"Authorization": "Bearer atb_live_YOUR_KEY"},
    params={"date_from": "2026-03-20", "date_to": "2026-03-25"},
)
data = res.json()["data"]

Response

Success response (200 OK)

{
  "data": [
    {
      "date": "2026-03-20",
      "visitors": 1250,
      "pageviews": 3600,
      "bounces": 520,
      "cash_revenue": 2400.00,
      "spend": 680.00
    },
    {
      "date": "2026-03-21",
      "visitors": 1180,
      "pageviews": 3400,
      "bounces": 490,
      "cash_revenue": 1800.00,
      "spend": 720.00
    },
    {
      "date": "2026-03-22",
      "visitors": 980,
      "pageviews": 2800,
      "bounces": 410,
      "cash_revenue": 3200.00,
      "spend": 650.00
    }
  ],
  "meta": {
    "date_from": "2026-03-20",
    "date_to": "2026-03-25",
    "profile_id": "uuid"
  }
}

Response fields

Field	Type	Description
`date`	string	Calendar date (`YYYY-MM-DD`).
`visitors`	number	Unique visitors (distinct `anonymous_id`) that day.
`pageviews`	number	Total page views recorded.
`bounces`	number	Sessions with a single page view.
`cash_revenue`	number	Attributed cash revenue (Stripe / MercadoPago) in your reporting currency.
`spend`	number	Total ad spend across all connected platforms.

Revenue is cash only

cash_revenue includes confirmed payments from Stripe and MercadoPago only. GHL pipeline values (deal stages, closed-won projections) are excluded because they are not confirmed cash. See Conversions & Revenue for the full breakdown.

Authentication

API key setup and scopes

Dashboard

The main chart uses the same data this endpoint returns