Create a new social-listening subscription from handles and/or discovery lists. Monitoring is billed per creator, per day — API calls are included in that price. See Usage, pricing & limits.
Platform to monitor. Optional when it can be derived from list_ids; required otherwise. Exactly one platform per subscription.
Event that triggers a notification (e.g. 'new_post', 'bio_change', 'follower_threshold').
Event-type-specific filter object. Required for 'follower_threshold'; shape is validated against the chosen event_type.
Discovery list IDs whose creators are monitored. Provide handles and/or list_ids.
Where matching events are delivered. At least one is required.
- Productionhttps://api-dashboard.influencers.club/public/v1/social/listening/subscription/
curl -i -X POST \
https://api-dashboard.influencers.club/public/v1/social/listening/subscription/ \
-H 'Authorization: Bearer <YOUR_API_KEY_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"name": "string",
"platform": "string",
"event_type": "string",
"filters": {
"property1": null,
"property2": null
},
"list_ids": [
0
],
"notify_endpoints": [
{
"id": 0,
"destination": "string",
"notify_type": "api"
}
],
"handles": [
"string"
]
}'Endpoints the subscription's events are delivered to.
Discovery lists feeding creators into the subscription.
Lifetime listening credits attributed to this subscription, accrued daily as 0.3 × its active creators (gross per-subscription). May exceed the deduplicated amount actually charged to the billing scope when creators are shared across subscriptions.
{ "id": 0, "name": "string", "subscription_type": "string", "platform": "string", "event_type": "string", "status": "string", "paused_reason": "string", "filters": { "property1": null, "property2": null }, "interval": "string", "notify_endpoints": [ { … } ], "source_lists": [ { … } ], "sample_creators": "string", "creator_count": "string", "delivery_health": "string", "last_event_at": "string", "credits_spent": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" }