# Campaign stats

Content count, views, engagement, and cost for one campaign.

## Get stats

`GET /v1/campaigns/{id}/stats`

Requires the `campaigns:read` scope. The `money` block is only returned with `finance:read`.

Stats are cached for up to 60 minutes, or 24 hours for finished campaigns. Responses carry an `ETag` header. Send it back in `If-None-Match`, and the API answers `304` with no body when nothing has changed.

| Field | Contents |
| --- | --- |
| `applicants` | Number of applications |
| `content` | Content count per status |
| `views.verified_total` | Total verified views |
| `views.by_platform` | Views per platform |
| `engagement` | Total likes, comments, shares, and their coverage |
| `money` | Budget, remaining budget, amount paid, and service fee |

Read [What the numbers mean](https://docs.wefluence.app/en/data/) before using these numbers in a report.

```bash
curl https://api.wefluence.app/v1/campaigns/abc123/stats \
  -H "Authorization: Bearer $WEFLUENCE_API_KEY"
```
```python
requests.get(f"{API}/campaigns/abc123/stats", headers=HEADERS).json()
```
```javascript
await (await fetch(`${API}/campaigns/abc123/stats`, { headers })).json();
```
```json
{
  "object": "campaign_stats",
  "campaign_id": "abc123",
  "applicants": 195,
  "content": {
    "pending_review": 0,
    "in_admin_moderation": 0,
    "approved": 783,
    "rejected": 26
  },
  "views": {
    "verified_total": 1414148,
    "by_platform": { "tiktok": { "views": 1414148 } }
  },
  "engagement": {
    "likes": 18014,
    "comments": 1224,
    "shares": 1693,
    "items_with_data": 587,
    "items_counted": 800
  },
  "money": {
    "currency": "IDR",
    "budget": 5000000,
    "remaining_budget": 0,
    "paid_to_creators": 5000000,
    "cost_per_1000_views": 3536,
    "platform_fee": 750000,
    "platform_fee_percent": 15
  },
  "as_of": "2026-11-02T09:00:00.000Z"
}
```
