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

# search_site_analytics

> The caller's website traffic report, one chart per call. Read-only.

> [!NOTE]
>
> **READ** · 8 operations · never changes data

Read the caller's website traffic — the same numbers as the Traffic Report in the Lofty CRM. Pick one chart with `kind`. Use it to quantify a problem found with `search_site_audit`, or to check whether a change paid off.

```js theme={null}
search_site_analytics({
  kind: "traffic_overview" | "traffic_trend" | "activity_by_hour" | "visitor_type"
      | "visitors_by_source" | "pageviews_by_device" | "activity_by_source"
      | "traffic_by_page_type",
  start_date?: string,   // yyyy-MM-dd, agent's time zone; defaults to 29 days before end_date
  end_date?: string,     // yyyy-MM-dd; defaults to today; the period is at most 365 days
  site_id?: string       // only for agents with several websites; defaults to the primary one
})
```

| kind | What it returns |
| - | - |
| `traffic_overview` | visitors / page views / page views per visitor, with the change against the previous period |
| `traffic_trend` | the same numbers per day |
| `activity_by_hour` | visitors per weekday (0 = Sunday) and hour |
| `visitor_type` | new vs returning visitors |
| `visitors_by_source` | Direct / Paid / Search Organic / Social Organic / Email / AI / Other |
| `pageviews_by_device` | desktop vs mobile |
| `activity_by_source` | listing views and searches per visitor, by source |
| `traffic_by_page_type` | page type × source table |


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