Skip to main content

The mention feed

GET 
/api/v3/listening/projects/:project/mentions

The mention feed (?platform, kind, source_id, sentiment, intent, author, q, from, to, sort, ad=1|0: only / no posts flagged as ads, include_hidden). Each mention has external_id (the id on the platform), kind (post | comment), intent (provider | seeker | general, null until classified) with intent_source (ai | rule | manual) and is_ad (the platform marks it as an ad or paid partnership, e.g. TikTok branded content and Shop affiliate videos; counted as Paid media); comments carry parent_external_id and parent_url (the post they are under). Images: media_type (video | image | carousel | text | comment | article | thread), media_count, media[] {position, url, thumb_url, mime_type, bytes} = the stored copies of every image of the post (a video's cover included) as signed links valid until the end of the next day, thumbnail_url = the stored grid-size copy of the first image (the platform's link until it is stored). Extended fields of a post, each null when the platform or the strategy did not say (never 0 for unknown): duration_seconds, video_width, video_height (videos), saves (TikTok collects, X bookmarks), quotes and reposts (X, Threads), reactions {like, love, care, haha, wow, sad, angry} (Facebook) or {⟨emoji⟩: n, custom, stars} (Telegram: custom emoji summed, paid Telegram Stars), post_language (the platform's ISO 639 code), place and place_id (tagged location), music {id, title, author, original} (TikTok, Instagram), post_format (short | reel | live | story | carousel | video | image | text), is_live, tagged_accounts (handles the post tags, mentions or credits as collaborators: public on the post), author_verified, youtube_category, youtube_tags, shop_products (TikTok: the TikTok Shop product ids the video tags, strings; filter with product); media_count also counts the media items the platform reports (a carousel's videos). Reviews (kind review: a customer's rating of a product, shop, place or app, from a review source; reviews skip the project's include keywords and languages, not its excluded words) carry rating (1..5), review_target {type product|shop|place|app, id, name, url}, variant (the option bought), verified_purchase, seller_reply {text, at} (the seller's public answer), likes (helpful votes) and media[] (the review's photos); each null on posts and comments and when the platform did not say

Request​

Responses​

{ data: Mention[], meta: { current_page, last_page, per_page, total } }