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 |
curl "https://api.wefluence.app/v1/campaigns/abc123/report?format=xlsx" \
-H "Authorization: Bearer $WEFLUENCE_API_KEY"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)const report = await (await fetch(`${API}/campaigns/abc123/report?format=xlsx`, { headers })).json();
const file = await fetch(report.url);{
"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.