attriboo reports timeseries

Read traffic and revenue over daily, weekly, monthly or quarterly buckets.

Access: OAuth analytics:read or workspace key

Options

attriboo reports timeseries options
Field	Type	Description
`--site`	`string`	Website ID or domain. Required when the workspace has more than one website.
`--period`	`string`	UTC date selection. from and to override period. Values: realtime, today, yesterday, 7d, 30d, 90d, 12m, wtd, mtd, qtd, ytd, all. Default: `30d`.
`--from`	`string`	Inclusive start date. Supply to as well.
`--to`	`string`	Inclusive end date. Supply from as well.
`--compare`	`string`	Comparison range. Values: previous_period, mom, qoq, yoy, none. Default: `previous_period`.
`--model`	`string`	How recorded sources share revenue credit. Values: first_touch, last_touch, linear, time_decay. Default: `first_touch`.
`--filters`	`string`	JSON array string of up to twenty visitor filters, for example [{"dim":"country","op":"is","value":"US"}]. Dimensions: source, channel, campaign, entry_page, page, hostname, country, device, browser, os, goal. Operators: is, is_not. Values are exact strings up to 500 characters. All filters must match the visitor across available history; report dates then select activity for that cohort. Unmatched payments are excluded. Crawler counts remain website-wide; spend requires every filter to be source/channel/campaign. Preserve filters when paging.
`--granularity`	`string`	Requested bucket size. Values: daily, weekly, monthly, quarterly. Default: `daily`.
`--json`	`boolean`	Compact JSON instead of formatted JSON.
`--csv`	`boolean`	CSV for the main row collection; nested values remain JSON cells. Cannot be combined with --json.

Read time series

Replace example websites, dates and cursor values with your own. Running these commands makes real requests or changes the local session.

Terminal command

attriboo reports timeseries --site shop.example.com --from 2026-10-01 --to 2026-10-07 --compare none --json

Example output

Illustrative stdout

{"site":{"id":"site_example","domain":"shop.example.com","currency":"USD"},"period":{"from":"2026-10-01T00:00:00.000Z","to":"2026-10-08T00:00:00.000Z","label":"Custom","compare":"none","attribution_model":"first_touch"},"granularity":"daily","points":[{"label":"Oct 1","visitors":100,"revenue":20000,"orders":4,"top_source":"Google Organic","comparison_visitors":null,"comparison_revenue":null}]}

Output fields

attriboo reports timeseries output fields
Field	Type	Description
`site`	`object`	Website ID, domain and currency.
`period`	`object`	Resolved UTC boundaries; to is the exclusive timestamp after the selected end date.
`granularity`	`string`	Requested bucket granularity; long ranges may be grouped more coarsely.
`points`	`array`	Report records. See the fields below.
`coverage`	`object`	When provided, describes completeness, snapshot time and row coverage. Row limits apply to this page, not to headline totals.

`site` fields

site nested fields
Field	Type	Description
`id`	`string`	Website ID.
`domain`	`string`	Website domain.
`currency`	`string`	Three-letter currency.

`period` fields

period nested fields
Field	Type	Description
`from`	`string`	Inclusive UTC start.
`to`	`string`	Exclusive UTC end.
`label`	`string`	Human-readable date selection.
`compare`	`string`	Comparison selection.
`attribution_model`	`string`	Revenue-credit model.

`points[]` fields

points nested fields
Field	Type	Description
`label`	`string`	Bucket label.
`from`	`string`	Optional database bucket inclusive UTC start.
`to`	`string`	Optional database bucket exclusive UTC end.
`gross_sales`	`integer`	Optional gross sales cents for database-backed results.
`refunds`	`integer`	Optional refund cents for database-backed results.
`visitors`	`integer`	Visitors in the bucket.
`revenue`	`integer`	Revenue in cents.
`orders`	`integer`	Order count.
`top_source`	`string \| null`	Leading source or null.
`comparison_visitors`	`number \| null`	Comparison visitors or null.
`comparison_revenue`	`number \| null`	Comparison revenue in cents or null.

The data follows the time series API contract. CLI JSON omits the REST envelope.

Behavior and limits

Money is integer cents in site.currency. Percentages use a 0–100 scale.

Long daily ranges can be grouped weekly, and long weekly ranges monthly. Inspect returned points rather than assuming one point per day.

Larger-site results may also include from, to, gross_sales and refunds per point and a coverage object.

CLI JSON output is the API data object directly, without the REST status/data envelope. Default output is formatted JSON; --json is compact JSON.

CSV contains only the returned page's main row collection. Continue using returned next_cursor values rather than assuming a single CSV is a complete export.

Exit codes and troubleshooting Environment and credentials Pagination and completeness