# Laporan

File Excel atau CSV satu kampanye, dibuat di server dan diunduh lewat link.

## Buat laporan

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

Butuh scope `content:read`. Server menyusun file lengkap satu kampanye, lalu menjawab dengan link unduhan. Isinya tidak ikut di jawaban, jadi cocok untuk kampanye dengan ribuan konten dan untuk asisten AI.

| Parameter | Tipe | Isi |
| --- | --- | --- |
| `format` | string | `xlsx` atau `csv`, bawaan `xlsx` |
| `status` | string | `approved`, `pending_review`, `rejected`, atau `all`, bawaan `approved` |

| Kolom | Isi |
| --- | --- |
| `url` | Link unduhan, berlaku 24 jam |
| `expires_at` | Waktu link berakhir |
| `rows` | Jumlah konten di file |
| `truncated` | `true` kalau konten melebihi 20.000 baris, yang masuk file adalah yang views-nya terbanyak |
| `reused` | `true` kalau memakai file yang dibuat kurang dari 60 menit lalu |

```bash
curl "https://api.wefluence.app/v1/campaigns/abc123/report?format=xlsx" \
  -H "Authorization: Bearer $WEFLUENCE_API_KEY"
```
```python
report = requests.get(
    f"{API}/campaigns/abc123/report",
    headers=HEADERS,
    params={"format": "xlsx"},
).json()

file = requests.get(report["url"])
open(report["file_name"], "wb").write(file.content)
```
```javascript
const report = await (await fetch(`${API}/campaigns/abc123/report?format=xlsx`, { headers })).json();
const file = await fetch(report.url);
```
```json
{
  "object": "report",
  "campaign_id": "abc123",
  "format": "xlsx",
  "status": "approved",
  "rows": 1248,
  "truncated": false,
  "file_name": "kampanye-oktober.xlsx",
  "url": "https://api.wefluence.app/v1/reports/rpt_Zk3v...",
  "expires_at": "2026-11-04T09:00:00.000Z",
  "reused": false
}
```
## Unduh file

`GET /v1/reports/{token}`

Tidak butuh key, jadi link bisa dibuka langsung di browser atau diberikan asisten AI kepadamu. Perlakukan link seperti file itu sendiri: siapa pun yang memegangnya bisa mengunduh sampai `expires_at`. Link mati lebih awal kalau key pembuatnya dicabut.

## Isi file Excel

| Lembar | Isi | Tersedia untuk |
| --- | --- | --- |
| Ringkasan | Total views, interaksi, engagement rate, jumlah kreator, rincian platform | Semua key |
| Konten teratas | Setiap konten dengan views, suka, komentar, bagikan, waktu pindai, status, dan link | Semua key |
| Performa kreator | Views, interaksi, engagement, jumlah konten, dan kontribusi tiap kreator | Semua key |
| Performa kampanye | Budget, sisa budget, status, dan tenggat | `finance:read` |

Dengan `finance:read`, lembar Ringkasan juga memuat budget, dibayar ke kreator, sisa budget, dan biaya per 1.000 views, sedangkan Performa kreator memuat pendapatan tiap kreator.

## Isi file CSV

Satu baris untuk tiap konten, dalam UTF-8. Nama kolomnya sama dengan API supaya mudah dipetakan:

`id`, `creator_name`, `creator_ref`, `platform`, `url`, `status`, `views`, `views_flagged`, `likes`, `comments`, `shares`, `scanned_at`, `submitted_at`, `reviewed_at`

## Batas

Satu key bisa membuat 30 laporan per hari. Permintaan yang sama dalam 60 menit memakai file yang sudah ada dan tidak dihitung lagi.
