Get project-global affiliate breakdown

GET https://api.fuul.xyz/api/v1/affiliate-portal/global-breakdown

Returns aggregated affiliate statistics for an entire project, grouped by a selected dimension (audience, region, or status).

This endpoint is designed for the Affiliate Management Breakdown page and provides project-wide totals along with per-group breakdowns.

Grouping:

• groupBy=region — Groups affiliates by their geographic region (CN, JP, KR, SEA, EN, LATAM, Other)
• groupBy=audience — Groups affiliates by the audience they belong to
• groupBy=status — Groups affiliates by their status (active, flagged, etc.)

Date Filtering Options:

• All-time (default): Omit date parameters
• Preset ranges: Use dateRange=7d, 30d, MTD, or QTD
• Custom range: Use dateRange=custom together with dateFrom and dateTo

Sorting:

• Use sortBy to sort groups by a metric: totalReferralVolume, revenueFromReferrals, earnings, or pointsPaid
• Use sortOrder to control direction: asc or desc (default: desc)

Required API Key Scope: service_role