Skip to content

Subscriptions

Create and manage social-listening subscriptions — the monitoring configs that watch a set of creators (by handle or discovery list) and deliver matching activity to your notify endpoints (e.g. a webhook URL). Covers listing, retrieving, updating and deleting subscriptions, and managing their creators, details and exports.

Operations

List subscriptions

Request

Return a paginated list of the client's social-listening subscriptions, optionally filtered by type. The response includes a summary block with aggregate counts. 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.

page_sizeinteger

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

curl -i -X GET \
  'https://api-dashboard.influencers.club/public/v1/social/listening/subscription/?page=0&page_size=0' \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>'

Responses

Bodyapplication/json
countintegerrequired

Total number of subscriptions 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(SubscriptionResponse)required

Subscriptions on the current page.

summaryobject(SubscriptionSummary)required

Aggregate counts across all subscriptions matching the filter.

Response
{
  "count": 0,
  "next": "http://example.com",
  "previous": "http://example.com",
  "results": [
    { … }
  ],
  "summary": {
    "active_subscriptions": 0,
    "deliveries_24h": { … },
    "success_rate": 0.1,
    "avg_detection_latency_seconds": 0.1
  }
}