# Content

Creator content in one campaign.

## List content

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

Requires the `content:read` scope. Content still being checked by our team is not included yet, the same as in the app.

| Parameter | Type | Contents |
| --- | --- | --- |
| `status` | string | `pending_review`, `approved`, or `rejected` |
| `limit` | integer | Rows per page, 1 to 100, default 50 |
| `cursor` | string | `next_cursor` from the previous page |

| Field | Contents |
| --- | --- |
| `id` | Stays the same on every pull, safe as a unique key |
| `creator.ref` | Stays the same for the same creator in your account |
| `url` | Content link |
| `status` | Content status |
| `rejection_reason` | Rejection reason, only for rejected content |
| `views.verified` | Verified views |
| `views.flagged` | `true` when the views were flagged as problematic |
| `engagement` | Likes, comments, and shares, or `null` if not scanned yet |

```bash
curl "https://api.wefluence.app/v1/campaigns/abc123/content?status=approved&limit=100" \
  -H "Authorization: Bearer $WEFLUENCE_API_KEY"
```
```python
requests.get(
    f"{API}/campaigns/abc123/content",
    headers=HEADERS,
    params={"status": "approved", "limit": 100},
).json()
```
```javascript
await (await fetch(`${API}/campaigns/abc123/content?status=approved&limit=100`, { headers })).json();
```
```json
{
  "object": "list",
  "data": [
    {
      "id": "cnt_8f3a1c9e42d70b15",
      "campaign_id": "abc123",
      "creator": { "ref": "crt_19ab77c0d2e4f611", "name": "Creator Name" },
      "platform": "tiktok",
      "url": "https://www.tiktok.com/@example/video/123",
      "status": "approved",
      "submitted_at": "2026-10-20T03:12:00.000Z",
      "reviewed_at": "2026-10-21T08:40:00.000Z",
      "views": { "verified": 12500, "flagged": false },
      "engagement": {
        "likes": 410,
        "comments": 22,
        "shares": 9,
        "scanned_at": "2026-10-27T02:00:00.000Z"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "eyJhIjoi...",
  "as_of": "2026-11-02T09:00:00.000Z"
}
```
## Top content

`GET /v1/campaigns/{id}/top-content`

Requires the `content:read` scope. Approved content with the most views, already sorted, without pulling every page. Each row has the same shape as the content list. The data is cached for up to 60 minutes, see `as_of`.

| Parameter | Type | Contents |
| --- | --- | --- |
| `limit` | integer | Number of rows, 1 to 100, default 20 |
| `platform` | string | `tiktok`, `instagram`, `youtube`, `facebook`, `threads`, `x`, or `capcut` |
| `min_views` | integer | Minimum views |

With `platform`, you get the top 50 for that platform. For all content, use a [report](https://docs.wefluence.app/en/reference/reports/).

```bash
curl "https://api.wefluence.app/v1/campaigns/abc123/top-content?platform=tiktok&limit=10" \
  -H "Authorization: Bearer $WEFLUENCE_API_KEY"
```
```python
requests.get(
    f"{API}/campaigns/abc123/top-content",
    headers=HEADERS,
    params={"platform": "tiktok", "limit": 10},
).json()
```
```javascript
await (await fetch(`${API}/campaigns/abc123/top-content?platform=tiktok&limit=10`, { headers })).json();
```
