Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Read product activity and revenue represented in the AI referral data.
get_product_performance. Operation: read. Uses the authorized connection; no project or content changes are made by this tool.
| Name | Type | Required | Default | Meaning and accepted values |
|---|---|---|---|---|
project_id | string | Yes | Required | Project ID from list_projects. Select the project in the intended workspace and environment. |
start_date | string | No | '30daysAgo' | Start of the requested range, as YYYY-MM-DD or a relative value such as 30daysAgo. These reads select a stored snapshot; use resolved_window for the dates actually served. |
end_date | string | No | 'today' | End of the requested range, as YYYY-MM-DD or today. Check resolved_window rather than treating the requested dates as the served period. |
session_source | string or null | No | null | Restrict rows to one AI referral source, such as a source returned by get_ai_traffic_sources. Omit to leave source unrestricted. |
limit | integer | No | 50 | Maximum product rows returned, ordered by item revenue. This selects a list, not a separate reporting period. |
params object for MCP tools/call.
{
"name": "get_product_performance",
"arguments": {
"project_id": "PROJECT_ID",
"start_date": "2026-09-01",
"end_date": "2026-09-30",
"limit": 20
}
}
| Field | Meaning and use |
|---|---|
linked | Whether a property link exists for this project. |
products | Product results when available. No product rows were invented for this unlinked example. |
{
"project_id": "PROJECT_ID",
"linked": false,
"products": []
}
| Field | Meaning and use |
|---|---|
resolved_window | Stored snapshot dates actually served; retain these dates with the report. |
products[].item_name | Product name in the stored ecommerce data. |
products[].item_brand | Product brand recorded by the linked property. |
products[].items_viewed | Item-view count in the selected scope. |
products[].items_added_to_cart | Items added to cart in the selected scope. |
products[].items_checked_out | Items reaching checkout in the selected scope. |
products[].items_purchased | Purchased-item count; it is not automatically a count of distinct purchasers. |
products[].item_revenue | Stored item revenue. Do not invent a currency when none is supplied. |
products[].conversion_rate | Purchased items divided by viewed items, or null when no views are recorded; not a session conversion rate. |