Listening: creators

📄️Creators ranked

Creators ranked (?sort=engagement|views|posts|followers|engagement_rate, ?q, ?platform, ?page). `followers` is the newest observed count, `peak_followers` the highest ever seen

📄️Bulk action on creators

Managers: follow (track: the creator's profile becomes a source of the project) or unfollow (untrack: that source is removed) up to 200 creators, each as POST/DELETE creators/{creator}/track does it. A creator that cannot be followed (its platform has no profile sources, the plan's source limit) is listed in `failed` and the rest go on. Ids of another project or repeated: 422, nothing changed. 20 a minute

📄️Creators as CSV or XLSX

Creators as CSV or XLSX (?format)

📄️A creator with their posts

A creator with their posts (?sort=published_at|views|engagement). `data` also carries the directory's `niche` (top hashtags), `sentiment` ({ positive, neutral, negative, unknown }) and `list_ids` (the account's creator lists holding them), here over this project only

📄️Track the creator

Track the creator: adds a profile source (plan source limit applies; not for Instagram)

📄️Stop tracking

Stop tracking (removes the source)

📄️The account's creator directory

The account's creator directory: authors of posts in the account's own projects (never guest-shared or other accounts' projects; restricted members see their assigned projects only), merged by platform + handle. Filters ?platform, ?q (handle/name), ?min_followers, ?max_followers, ?min_engagement_rate, ?max_engagement_rate (fractions, 0.05 = 5 %), ?niche (hashtag or word in their posts), ?location, ?list_id; ?sort=followers|engagement_rate|engagement|views|posts|last_post_at, ?direction=asc|desc, ?page, ?per_page. Each row: key, platform, handle, name, url, avatar_url, location, followers (highest current count over projects), posts, views, likes, comments, shares, engagement, engagement_rate (engagements per view, or per follower per post without views), first_post_at, last_post_at, last_seen_at, projects, niche (top 5 hashtags), sentiment {positive, neutral, negative, unknown} of their posts, list_ids

📄️One creator of the directory

One creator of the directory (?platform, ?handle): the directory row, `projects` [{id, name}] they posted in, and their recent visible `posts` (each with project_id; ?sort=published_at|views|engagement, ?page, ?per_page ≤ 60). 404 outside the account

📄️The filtered directory as CSV

The filtered directory as CSV (UTF-8 BOM, formula cells prefixed with ') or XLSX (?format); same filters as the list, at most 20 000 rows

📄️The account's named creator lists

The account's named creator lists (shortlists) with their `creators` count

📄️Create creator list (listening)

Create a list {name (unique in the account), description?}; at most 100 per account; listening.manage

📄️Rename or describe a list

Rename or describe a list

📄️Delete a list

Delete a list (the creators stay in the directory)

📄️Add creator to creator list

Save a creator {platform, handle} to the list; only creators in the person's directory (422 otherwise); at most 2 000 per list; idempotent (200 when already saved)

📄️Remove a creator from the list

Remove a creator from the list (?platform, ?handle)

📄️Bulk action on creators

listening.manage: add (action add) or remove (action remove) up to 200 creators at once, as the single POST / DELETE do it. Adding saves creators of your creator directory; ones already on the list count as added; any other creator (another account's, or followed in a project with no post yet) and ones past the list's size limit (2000) are listed in `failed` with id platform:handle. A creator named twice: 422, nothing saved. 20 a minute

📄️Authors of the filtered mentions

Authors of the filtered mentions (reviews count only with kind=review: reviewers are customers, not influencers): mentions, posts, comment_mentions, reviews, interactions, reactions, comments, shares, views, followers, sentiment { positive, neutral, negative, unknown }, sentiment_score ((positive − negative) / (positive + negative + neutral), −1..1, 3 places; null without labelled mentions), last_at. sort mentions|interactions|posts|shares|views|followers|positive|negative, direction asc|desc, per_page; sentiment_score_min / sentiment_score_max (−1..1) keep authors in that score range, and leave out the ones without labelled mentions

📄️Influencers as CSV/XLSX

Influencers as CSV/XLSX (?format), same filters, sort and sentiment score range, at most 10 000 rows; last column sentiment_score