Skip to main content
One call gives the headline numbers; three more fill in where they came from. Use this for a weekly or monthly report, or to answer “how’s the business doing?”.

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_pct is null when the previous period was zero: report “nothing to compare with”, not a percentage.
  • top_products is ranked by units sold, not revenue.
  • Refunds are counted by the date of the original order.
These are the review’s headline numbers.
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.