Dates, money and attribution

Base URL and website selection

REST base URL: https://www.attriboo.com/api/v1. All paths in endpoint pages are relative to this base. site accepts a website ID or domain and can be omitted only when the workspace has exactly one website.

Path parameters named {site} accept an ID or domain. Payment and crawler bodies use siteId and require a website ID. Server events use site and visitor_id. Preserve the exact spelling shown on each endpoint page.

Date ranges use UTC

period defaults to 30d. Allowed selections are realtime (last 30 minutes), today, yesterday, 7d, 30d, 90d, 12m, wtd, mtd, qtd, ytd and all. all is still constrained by available report history.

Custom dates use from=YYYY-MM-DD and to=YYYY-MM-DD. Both are required, both are inclusive, and they override period. The returned period.to timestamp is the exclusive UTC end after the selected final date. The website's saved timezone does not change these REST report boundaries.

The dedicated /stats/realtime endpoint always uses a five-minute window; its date selection differs from period=realtime on other reports.

GET /api/v1/stats/sources?site=site_example&from=2026-10-01&to=2026-10-07&compare=none

Comparisons and attribution models

compare defaults to previous_period; other values are mom, qoq, yoy and none. Changes are percentages, not percentage-point differences; a comparison without data can return null.

model defaults to first_touch. Choose first_touch, last_touch, linear or time_decay. Source, campaign and landing-page revenue and conversion credit follow the model. Multi-touch credit can be fractional. Attribution assigns credit to observed activity; it does not establish causation or fill gaps in tracking.

Money, ratios and missing values

Money is integer cents in site.currency unless a field explicitly names a transaction currency. For example, 5000 means 50.00 USD on a USD website. No automatic currency conversion is offered.

Percentages are on a 0–100 scale. ROAS is a ratio: 4 means four units of recorded revenue per unit of recorded ad spend. ROAS is null when no spend is available; null should not be converted to zero.

Revenue less advertising cost is not accounting profit after fees, taxes and every other business expense.

Reporting capacity

Reports cover available records in the latest 365 days. Monthly collection allowances and report history are separate. Core reports and supported details use database calculations for larger sites; this is not a response-time guarantee at every traffic level.

A capacity failure is an explicit error, not zero activity. Shorten the requested range or retry, and avoid presenting incomplete results as a total. Detailed row lists have their own limits and continuation behavior.