Skip to content

Events

Activity detected on monitored creators — events such as new_post, bio_change and follower_threshold — with the full payload and per-endpoint delivery history and status (pending / sending / sent / failed / retrying). List events or fetch a single event.

Operations

List events

Request

Return a paginated list of the client's events, optionally filtered by subscription, event type, or creator. 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.

subscription_idinteger

Return only events belonging to this subscription.

event_typestring

Filter events by type (e.g. 'new_post', 'bio_change').

creatorstring

Filter events by creator handle (exact match).

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/events/?page=0&subscription_id=0&event_type=string&creator=string&page_size=10' \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>'

Responses

Bodyapplication/json
countintegerrequired

Total number of events 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(EventResponse)required

Events on the current page.

Response
{
  "count": 0,
  "next": "http://example.com",
  "previous": "http://example.com",
  "results": [
    { … }
  ]
}