Reporting & Analytics

Drapier API provides reporting endpoints for clicks, commissions, and invoices. Use these to build dashboards, automate performance reports, or export data to your analytics stack.

Available reports

Report	Endpoint	Description
Click statistics	`GET /clicks/stats/me`	Aggregate click and unique-click counts by time period
Commission list	`GET /commissions/me`	Detailed commission records with filtering
Invoice history	`GET /invoices`	Monthly invoice summaries and payment status

Click statistics

Retrieve lifetime and recent performance statistics for your publisher account.

curl https://api.drapier.io/api/v1/clicks/stats/me \
  -H "Authorization: Bearer YOUR_API_KEY"

This endpoint takes no query parameters. It returns lifetime totals plus pre-computed 7-day and 30-day windows.

Response:

{
  "totalClicks": 15432,
  "totalConversions": 127,
  "totalRevenue": 254000.00,
  "totalCommissions": 12700.00,
  "conversionRate": 0.0082,
  "epc": 0.82,
  "lastClickAt": "2026-03-18T10:30:00Z",
  "lastConversionAt": "2026-03-17T14:22:00Z",
  "last30d": {
    "conversions": 42,
    "revenue": 84000.00,
    "commissions": 4200.00
  },
  "last7d": {
    "conversions": 11,
    "revenue": 22000.00,
    "commissions": 1100.00
  }
}

Response fields:

Field	Type	Description
`totalClicks`	number	Lifetime click count
`totalConversions`	number	Lifetime conversion count
`totalRevenue`	number	Lifetime attributed sale revenue
`totalCommissions`	number	Lifetime commission earnings
`conversionRate`	number	`totalConversions / totalClicks`
`epc`	number	Earnings per click: `totalCommissions / totalClicks`
`last30d`	object	Conversions, revenue, and commissions from the last 30 days
`last7d`	object	Conversions, revenue, and commissions from the last 7 days

Commission reporting

List all commissions with filtering by status.

curl https://api.drapier.io/api/v1/commissions/me \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -G \
  -d status=APPROVED \
  -d limit=50

Response:

{
  "items": [
    {
      "id": "comm_abc123",
      "publisherId": "pub_123",
      "orderId": "ORD-1234",
      "orderName": "#1234",
      "orderDate": "2026-03-14T18:22:00Z",
      "productTitle": "Gucci Marmont Bag",
      "productBrand": "Gucci",
      "productSku": "GUC-MM-BLK-001",
      "salePrice": 1200.00,
      "commissionAmount": 240.00,
      "status": "APPROVED",
      "currency": "USD",
      "createdAt": "2026-03-14T18:25:00Z"
    }
  ],
  "total": 127,
  "page": 1,
  "limit": 50,
  "totalPages": 3
}

Filters:

Parameter	Type	Description
`status`	string	`PENDING`, `APPROVED`, `LOCKED`, `PAYABLE`, `INVOICED`, `PAID`, or `REVERSED`
`page`	number	Page number (default `1`)
`limit`	number	Results per page (default `50`)

Key metrics

Use the reporting data to calculate performance metrics for your integration:

Conversion Rate

Conversion Rate = Total Commissions / Total Clicks

A healthy conversion rate on luxury fashion is typically 0.5–2%. If yours is below 0.3%, review your traffic quality and landing page relevance.

EPC (Earnings Per Click)

EPC = Total Commission Amount / Total Clicks

EPC tells you how much revenue each click generates on average. With luxury price points, expect $0.50–$5.00 EPC depending on product mix.

AOV (Average Order Value)

AOV = Total Sale Revenue / Total Orders

Higher AOV means higher commissions per sale. Focus on promoting full-price, high-earning items.

Example calculation

Given a report period with:

15,432 clicks
127 commissions totaling $12,700
$254,000 total sale revenue

Metric	Calculation	Result
Conversion Rate	127 / 15,432	0.82%
EPC	$12,700 / 15,432	$0.82
AOV	$254,000 / 127	$2,000

Invoice history

List your invoices to track payment status.

curl https://api.drapier.io/api/v1/invoices \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "data": [
    {
      "id": "inv_2026_02",
      "period": "2026-02",
      "totalAmount": 4250.00,
      "commissionCount": 62,
      "status": "PAID",
      "currency": "USD",
      "createdAt": "2026-03-01T00:05:00Z",
      "paidAt": "2026-03-15T09:00:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 3,
    "totalPages": 1
  }
}

Exporting data

Export commission data as CSV for use in spreadsheets or BI tools:

curl https://api.drapier.io/api/v1/commissions/me \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: text/csv" \
  -G \
  -d status=APPROVED \
  -o commissions-approved.csv

The CSV export includes all fields from the JSON response, flattened into columns.

Building a custom dashboard

Combine the three reporting endpoints to build a publisher dashboard:

async function fetchDashboard(apiKey) {
  const headers = { Authorization: `Bearer ${apiKey}` };

  const [stats, commissions, invoices] = await Promise.all([
    fetch("https://api.drapier.io/api/v1/clicks/stats/me", {
      headers,
    }).then((r) => r.json()),
    fetch("https://api.drapier.io/api/v1/commissions/me?limit=50", {
      headers,
    }).then((r) => r.json()),
    fetch("https://api.drapier.io/api/v1/invoices", { headers }).then(
      (r) => r.json()
    ),
  ]);

  return {
    totalClicks: stats.totalClicks,
    totalConversions: stats.totalConversions,
    totalEarnings: stats.totalCommissions,
    conversionRate: stats.conversionRate,
    epc: stats.epc,
    last30d: stats.last30d,
    last7d: stats.last7d,
    recentCommissions: commissions.items,
    pendingInvoices: invoices.data.filter((i) => i.status !== "PAID"),
  };
}

Reporting & Analytics

On this page