Skip to content

List campaigns

Request

Return a paginated list of the client's campaigns, optionally filtered by status and search, with a status_counts summary. Monitoring is billed per creator, per day — API calls are included in that price. See Usage, pricing & limits.

Security
Bearer
Query
pageinteger

Page number (1-based) for the paginated result.

statusstring

Filter campaigns by lifecycle status. Omit to return all statuses.

searchstring

Filter campaigns by name (case-insensitive substring match).

orderingstring

Sort field; prefix with '-' for descending. Defaults to newest first ('-created_at').

Default:"-created_at"
page_sizeinteger

Number of results to return per page. Defaults to 10.

Default:10
curl -i -X GET \
  'https://api-dashboard.influencers.club/public/v1/social/listening/campaign/?page=0&status=string&search=string&ordering=-created_at&page_size=10' \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>'

Responses

Bodyapplication/json
countintegerrequired

Total number of campaigns matching the filter.

nextstring or null, (uri)

URL of the next page, or null on the last page.

previousstring or null, (uri)

URL of the previous page, or null on the first page.

resultsArray of objects(CampaignListResponse)required

Campaigns on the current page.

status_countsobject(CampaignStatusCounts)required

Counts of the client's campaigns by status. Computed across all campaigns in scope, ignoring the status filter.

Response
{
  "count": 0,
  "next": "http://example.com",
  "previous": "http://example.com",
  "results": [
    { … }
  ],
  "status_counts": {
    "draft": 0,
    "active": 0,
    "paused": 0,
    "completed": 0
  }
}