> ## Documentation Index
> Fetch the complete documentation index at: https://crevio.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Review how the business is doing

> Build a weekly or monthly business review from the business overview, site analytics, ad reports and customers.

**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](https://crevio.co/docs/developer/guides/ads-and-voice.md).

**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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.