Listening: analytics
Get analytic (listening › projects)
Totals, per-day per-platform series, sentiment, top creators and hashtags (?days=)
KPI cards with the previous period
KPI cards with the previous period (value, previous, change; change null = new): mentions, posts (posts only: no comments, no reviews), comment_mentions, review_mentions, unique_authors, unique_sources, reactions, comments, shares, views, interactions (= reactions + comments + shares), buzz (= mentions + interactions); interactions_breakdown (share); by_platform (mentions, previous_mentions, change, share, …); daily (mentions, posts, comment_mentions, interactions, buzz…); sentiment, sentiment_buzz, sentiment_by_day (⟨s⟩ and ⟨s⟩_buzz); intent { provider, seeker, general, unknown }, intent_share { provider, seeker, general } (0..1 of the classified mentions), intent_by_day (day + the four counts); media (own|paid|earned); attributes (id, name, type, color, mentions, interactions, sentiment); duration { videos (mentions with a known video length), avg_duration_seconds (null without any), buckets [{ bucket under_15s|15_60s|1_3m|3_10m|over_10m, mentions, share (of videos), interactions, avg_interactions }] }; post_formats [{ format short|reel|live|story|carousel|video|image|text|unknown, mentions, share (of posts), interactions }] (posts only). compare_from/compare_to pick the comparison period (default: the same length right before); attribute_type (attribute|product_line|topic_cluster|tracking_term, comma list) breaks down only the attributes of those types. reviews { reviews, rated (with a rating), avg_rating (2 places, null without any), distribution { 1..5: count }, with_seller_reply, reply_rate (0..1 of reviews, null without any), verified_purchases, by_day [{ day, reviews, avg_rating }], variants [{ variant, reviews, avg_rating }] (top 10), has_review_sources (the project watches a product, shop, place or app) }; by_platform and daily also carry review_mentions
Policy D22), over the distinct authors
Audience estimates, AGGREGATE only (policy D22), over the distinct authors (platform + handle) of the filtered mentions: gender from public display names read as Vietnamese names (middle name Thị/Văn, a curated list of clearly gendered given names; unisex, nickname, brand and page names unknown) and province from the profile location the platform returns (TikTok region, X location, YouTube channel country), normalized to the 34 provinces (former 63 as aliases) or abroad. Pages, news sites, owned accounts and Facebook page posts count in n without an estimate. Any bucket under k = 10 authors is null (shown as ⟨10); when either gender is under k both are. No age, no relationship status. Never returned per author: not in the feed, influencers, leads, creators or any export. Aggregate cached 5 minutes per project + filters
List audience estimates (listening › projects)
Aggregate audience estimates an AI agent or API client sent for the project (newest first, at most 20): gender and age band COUNTS of a period, never per person (policy D22). Shown with buckets under k = 10 authors as null: female and male both null when either is under k; age bands under k left out, together as `other` when they reach k, else counted in `unknown`
Send an aggregate estimate
Send an aggregate estimate (analysts and up; 20 a minute). `authors` = distinct authors looked at, at least k and at most the project's distinct authors in the period (dashboard filters); female + male and the age bands may not add up to more. Authors not judged stay out of the counts. No per-person field is accepted. Also the MCP tool save-audience-estimate
Remove an estimate
Remove an estimate (analysts and up)
Top hashtags
Top hashtags (?limit, 20): mentions, interactions, previous, change, rising (new, or +50 % with ≥ 3 mentions)
Topic cloud
Topic cloud (?limit, 80): Vietnamese-aware 1–3 word phrases (diacritics kept, VN + EN stopwords, URLs/mentions/numbers/emoji dropped, #tags merged with the phrase they spell); term, kind (phrase|hashtag|phrase+hashtag), count (posts), weight, sentiment. buzz=1 weighs posts by interactions (log); the project's keywords and brands are left out unless include_brand=1
Spike days
Spike days (≥ 3 mentions and ⟩ 2× the median of the 14 days before, or z ≥ 2), biggest 5: day, mentions, baseline, ratio, z, interactions, top_posts, top_authors, top_hashtags, sentiment, platforms