> For the complete documentation index, see [llms.txt](https://docs.fuul.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fuul.xyz/fuul-mcp-server/affiliates/affiliate-analytics.md).

# Affiliate Analytics

Ask your AI assistant anything about your affiliate program — top performers, volume by region, earnings by tier — without opening the dashboard or writing a single query. Just ask and get answers instantly.

No project API key needed, just log in to your Fuul account via the MCP.

## Program overview

Get aggregated performance metrics for all affiliates in a project:

> "How are our affiliates performing this month?"

{% hint style="info" %}
Supports date ranges: 7d, 30d, 90d, MTD, QTD, all, or a custom date range. You can also filter by statuses, regions, audiences, or tiers.
{% endhint %}

## Breakdown by group

Slice affiliate performance by a specific dimension:

> "Break down affiliate performance by tier"

> "Which regions are driving the most referral volume?"

| `groupBy` value | Description                |
| --------------- | -------------------------- |
| `audience`      | Group by audience segment  |
| `tier`          | Group by affiliate tier    |
| `region`        | Group by geographic region |
| `status`        | Group by affiliate status  |

{% hint style="info" %}
You can sort results by total referral volume, revenue from referrals, earnings, or points paid.
{% endhint %}

## Individual affiliate stats

Look up the performance of a specific affiliate:

> "Show me CryptoKing's stats"

{% hint style="info" %}
Returns the affiliate's performance (referral volume, revenue, earnings, referred users) alongside their current tier, status, region, and referral codes.
{% endhint %}