Recipe
1
Get the overview for the period
GET /v1/analytics?start_date=2026-11-01&end_date=2026-11-07 (both default to the last 7 days ending today) returns revenue, orders, leads, new customers, refunds, top products and site traffic. Each comes with the previous period of the same length and a change_pct.- Amounts are in the smallest unit of the response’s
currency. change_pctisnullwhen the previous period was zero: report “nothing to compare with”, not a percentage.top_productsis ranked by units sold, not revenue.- Refunds are counted by the date of the original order.
2
Add website traffic
If the business has a site (
GET /v1/sites), GET /v1/sites/{id}/analytics?start_date=…&end_date=… adds visitors, new versus returning visitors, a conversion funnel, a daily series, and top sources and pages.3
Add ad results, if they advertise
GET /v1/ads/campaigns lists campaigns with their metrics; GET /v1/ads/reports gives day-by-day performance for a connected ad account. See Ads and voice.4
Find the best customers
GET /v1/contacts?lifecycle=customer returns each contact’s orders_count and total_spend. Page through all of them with starting_after before ranking. total_spend is lifetime, not for the period.5
Write it up
Lead with revenue and its change, then what sold, where visitors came from, and two or three observations the numbers support. Don’t attribute causes the data can’t show. Offer next steps, such as a discount for leads who haven’t bought, and act only on a yes.

