FeedMCP

Docs

Objects

Whatever the platform, the same kind of data has the same fields. Fields a platform does not have are null.

Post post

Returned by: xiaohongshu.notes.get、xiaohongshu.users.notes.list、xiaohongshu.notes.search、douyin.videos.get、douyin.users.videos.list、douyin.videos.search、wechat_mp.articles.get、wechat_mp.accounts.articles.list、weibo.posts.get、weibo.users.posts.list、weibo.posts.search、bilibili.videos.get、bilibili.users.videos.list、bilibili.videos.search、tiktok.videos.search、tiktok.videos.get、tiktok.users.videos.list、youtube.videos.search、youtube.videos.get、youtube.channels.videos.list、instagram.users.posts.list、instagram.posts.get、instagram.hashtags.posts.list、instagram.reels.search、x.posts.search、x.posts.get、x.users.posts.list、threads.posts.search、threads.posts.get、threads.users.posts.list、telegram.channels.posts.list、telegram.posts.get、reddit.posts.search、reddit.subreddits.posts.list、reddit.posts.get、linkedin.posts.search、linkedin.posts.get、linkedin.companies.posts.list、facebook.pages.posts.list、facebook.posts.get、pinterest.pins.search、pinterest.pins.get、pinterest.boards.pins.list、kuaishou.videos.search、kuaishou.videos.get、kuaishou.users.videos.list、wechat_channels.users.videos.list、wechat_channels.videos.get、zhihu.posts.search、zhihu.questions.get、zhihu.questions.answers.list、zhihu.answers.get、zhihu.users.answers.list、douyin.xingtu.creators.videos.list、douyin.xingtu.videos.report.get、xiaohongshu.pgy.creators.notes.list、xiaohongshu.pgy.notes.get、xiaohongshu.pgy.notes.trending、douyin.index.videos.search、douyin.index.creators.videos.list、wechat_mp.articles.search、wechat_channels.videos.search、wechat_channels.users.live_replays.list、x.communities.posts.list、x.lists.posts.list、x.posts.quotes.list、x.users.mentions.list、x.posts.thread.list、x.posts.article.get

Field Type Description
id string The platform ID, which the platform's detail endpoint takes: TikTok or Douyin video ID, YouTube video ID, Instagram or Threads code, X post ID, Telegram "channel/number", Reddit short ID, LinkedIn activity number, Pinterest pin number, Kuaishou 3x… video ID, WeChat Channels object ID, Zhihu answer, question or article ID, Xiaohongshu note ID, BV ID, Weibo ID or article ID
platform string Platform: tiktok, youtube, instagram, x, threads, telegram, reddit, linkedin, facebook, pinterest, xiaohongshu, douyin, kuaishou, wechat_mp, wechat_channels, weibo, zhihu or bilibili
type string video, note, article, post (Weibo, X, Threads, Telegram, Reddit, LinkedIn, Facebook, Pinterest, Instagram photos), question or answer (Zhihu)
url string Link to the original
title string | null Title (YouTube, Reddit, Pinterest, Bilibili, Xiaohongshu and WeChat; for a Zhihu answer, its question; null elsewhere)
text string | null Body text or caption
created_at string | null Published at, ISO 8601, UTC
author.id string | null Author ID; pass it straight to that platform's account endpoints
author.name string | null Author name
metrics.views number | null Views or plays (null when the platform hides it)
metrics.likes number | null Likes (score on Reddit, total reactions on Facebook)
metrics.comments number | null Comments
metrics.shares number | null Shares or reposts (reposts on X)
metrics.quotes number | null Quotes (X and Threads)
metrics.reactions number | null Total reactions (Telegram only)
metrics.answers number | null Answers (Zhihu questions only)
metrics.upvote_ratio number | null Upvote ratio from 0 to 1 (Reddit only)
metrics.repins number | null Repins (Pinterest only)
metrics.favorites number | null Saves (bookmarks on X, saves on Pinterest)
cover string | null Cover image URL
duration_seconds number | null Video length in seconds
tags string[] Hashtags (the flair on Reddit)
community string | null Subreddit (Reddit only)
link string | null The page a pin links to (Pinterest only)

Comment comment

Returned by: xiaohongshu.notes.comments.list、douyin.videos.comments.list、wechat_mp.articles.comments.list、weibo.posts.comments.list、bilibili.videos.comments.list、tiktok.videos.comments.list、tiktok.shop.products.reviews.list、youtube.videos.comments.list、instagram.posts.comments.list、x.posts.replies.list、threads.posts.replies.list、reddit.posts.comments.list、facebook.posts.comments.list、kuaishou.videos.comments.list、wechat_channels.videos.comments.list、zhihu.answers.comments.list、tiktok.videos.comments.replies.list、douyin.videos.comments.replies.list、xiaohongshu.notes.comments.replies.list、kuaishou.videos.comments.replies.list、zhihu.comments.replies.list、weibo.comments.replies.list、instagram.posts.comments.replies.list、bilibili.videos.comments.replies.list、wechat_mp.articles.comments.replies.list、youtube.videos.comments.replies.list、wechat_channels.videos.comments.replies.list

Field Type Description
id string Comment ID
platform string Platform
text string | null Comment text
created_at string | null Posted at, ISO 8601, UTC
author.id string | null Commenter ID (none for WeChat comments)
author.name string | null Commenter name
likes number | null Likes (score on Reddit, reactions on Facebook)
reply_count number | null Replies
replies_token string | null Token for this comment’s replies (YouTube only; pass it to the replies endpoint)
rating number | null Stars, 1–5 (TikTok Shop reviews only)
variant string | null Variant bought (TikTok Shop reviews only)
images string[] Buyer photos (TikTok Shop reviews only)
verified_purchase boolean | null Verified purchase (TikTok Shop reviews only)

Account account

Returned by: xiaohongshu.users.get、douyin.users.get、wechat_mp.accounts.get、weibo.users.get、bilibili.users.get、tiktok.users.get、youtube.channels.get、instagram.users.get、x.users.get、threads.users.get、telegram.channels.get、reddit.subreddits.get、linkedin.users.get、linkedin.companies.get、facebook.pages.get、meta.advertisers.search、google.advertisers.search、kuaishou.users.get、wechat_channels.users.get、zhihu.users.get、tiktok.users.search、douyin.users.search、xiaohongshu.users.search、kuaishou.users.search、zhihu.users.search、weibo.users.search、instagram.users.search、youtube.channels.search、bilibili.users.search、wechat.accounts.search、wechat_mp.accounts.owner.get、x.users.followers.list、x.users.following.list、x.posts.retweeters.list、x.communities.get、x.communities.members.list、x.lists.members.list、x.lists.followers.list、x.users.search

Field Type Description
id string Account ID, the same id the platform's account endpoints take: the username on TikTok, Instagram, X and Threads, the channel name on Telegram, the subreddit name on Reddit, the part after /in/ or /company/ on LinkedIn, the page name or number on Facebook, the UC… channel ID on YouTube, sec_user_id on Douyin, the numeric user ID on Kuaishou, v2_…@finder on WeChat Channels, the profile token on Zhihu, the user ID on Xiaohongshu, the UID on Bilibili and Weibo, the gh_… ID on WeChat
platform string Platform
name string | null Display name
handle string | null Handle: username, Douyin ID, RED ID or WeChat ID
uid string | null Numeric Douyin uid (Douyin only; the Ocean Engine creator endpoints take it)
bio string | null Bio
avatar string | null Avatar URL
url string | null Profile link
verified boolean | null Verified
verified_reason string | null Verification label or owner
metrics.followers number | null Followers
metrics.following number | null Following
metrics.posts number | null Posts
metrics.likes number | null Likes received
metrics.views number | null Total views (YouTube channels only)
metrics.employees number | null Employees (LinkedIn companies only)
metrics.weekly_active_users number | null Weekly active users (subreddits only)
metrics.articles number | null Articles (Zhihu account search only)
private boolean | null Private account (Instagram account search only)
owner object | null The registered owner: name, country, registered_at, verified_at and third_party_services (account owner endpoint only)
metrics.ads number | null Roughly how many ads (Google advertisers only)
metrics.instagram_followers number | null Followers of the linked Instagram (Meta advertisers only)
location string | null Location (LinkedIn and Facebook)
category string | null Category: Facebook page category, LinkedIn industry, or WeChat account type (Official Account, service account, Channels or mini program)
website string | null Website (LinkedIn companies and Facebook pages)
experience object[] LinkedIn: organizations shown publicly, with organization, location, start and end
education object[] LinkedIn: schools and organizations shown publicly, with school, start and end

Trend trend

Returned by: douyin.trends.list、weibo.trends.list、bilibili.trends.list、tiktok.trends.list、x.trends.list、kuaishou.trends.list、zhihu.trends.list、xiaohongshu.pgy.keywords.related、douyin.index.keywords.related、douyin.index.trends.list、wechat.keywords.related

Field Type Description
rank number Rank; 0 means pinned
platform string Platform
keyword string Term
heat number | null Heat (each platform counts its own way)
label string | null Label, such as pinned or hot
url string | null Search link on the platform

Ad ad

Returned by: tiktok.ads.search、tiktok.ads.get、linkedin.ads.search、linkedin.ads.get、meta.ads.search、meta.advertisers.ads.list、meta.ads.get、google.advertisers.ads.list、google.ads.get

Field Type Description
id string Ad ID, which the library's ad endpoint takes: the library ID on Meta, "AR…/CR…" on Google, a number on LinkedIn and TikTok
platform string Library: meta, google, linkedin or tiktok
url string | null Link to the ad in the library
advertiser.id string | null Advertiser ID: the Facebook page ID on Meta, the AR… ID on Google; pass it to that library's advertiser ads
advertiser.name string | null Advertiser name
format string | null Format, such as image, video, text, dpa (dynamic product ads) or Carousel Ad
headline string | null Headline
text string | null Body copy
cta string | null Call-to-action text, such as Shop now
landing_url string | null Landing page
images string[] Image URLs
videos string[] Video URLs
first_shown string | null First shown, ISO 8601, UTC
last_shown string | null Last shown (today for ads still running)
active boolean | null Still running (Meta only)
placements string[] Placements (Meta only): facebook, instagram, messenger, threads or audience_network
countries string[] Countries shown in, two-letter codes (when the library publishes them)
impressions {min, max} | null Impression range (when the library publishes it; reach range on TikTok)
paid_by string | null Who paid (LinkedIn, and political ads on Meta)

Product product

Returned by: tiktok.shop.products.search、tiktok.shop.products.get、tiktok.shop.sellers.products.list

Field Type Description
id string Product ID; pass it to the product and review endpoints
platform string Platform: tiktok
url string | null Product page link
title string | null Product title
images string[] Product images (the main image only in lists)
price.amount number | null Price
price.original number | null List price (only when discounted)
price.currency string | null Currency, such as USD
rating number | null Rating out of 5
review_count number | null Reviews
sold_count number | null Units sold
category string | null The most specific category
shop.id string | null Shop ID; pass it to the shop's product list
shop.name string | null Shop name
shop.rating number | null Shop rating (product endpoint only)
shop.followers number | null Shop followers (product endpoint only)
shop.sold_count number | null Shop units sold (product endpoint only)
country string | null Country store, such as US

Creator creator

Returned by: douyin.xingtu.creators.lookup、douyin.xingtu.creators.search、douyin.xingtu.creators.get、douyin.xingtu.creators.similar.list、xiaohongshu.pgy.creators.search、xiaohongshu.pgy.creators.get、xiaohongshu.pgy.creators.similar.list

Field Type Description
id string The creator's ID on the marketing platform: the Xingtu ID on Douyin, the user ID on Xiaohongshu; every creator endpoint of that platform takes it
platform string Platform: douyin or xiaohongshu
name string | null Name
avatar string | null Avatar
gender 'male' | 'female' | null Gender
location string | null Location
account_id string | null The linked account ID (Douyin sec_user_id or Xiaohongshu user ID) for the account endpoints
handle string | null Douyin handle or RED ID
url string | null Creator page on Xingtu or PGY
mcn string | null Agency (PGY profiles only)
uid string | null Numeric Douyin uid (Xingtu only; the Ocean Engine creator endpoints take it)
tags string[] Content tags
followers number | null Followers
prices {type, price}[] Rates in CNY: 21–60s and 60s+ videos on Xingtu (search results only; use the rates endpoint for all), picture and video notes on PGY
metrics.expected_views number | null Expected views per video
metrics.views_median_30d number | null Median views, last 30 days
metrics.interaction_rate_30d number | null Interaction rate, last 30 days, 0–1
metrics.completion_rate_30d number | null Completion rate, last 30 days, 0–1
metrics.cpm_21_60s number | null Expected CPM for 21–60s videos (CNY)
metrics.star_index number | null Xingtu star index
metrics.read_median number | null PGY: median reads
metrics.engagement_median number | null PGY: median engagements
metrics.picture_read_cost number | null PGY: cost per read, picture notes (CNY)

Rate rate

Returned by: douyin.xingtu.creators.rates.get

Field Type Description
platform string Platform
type string Kind of work, such as integrated or custom video
price number | null Price
original_price number | null List price
currency string Currency: CNY
settlement string | null Settlement, such as fixed price
available boolean | null Open for orders

Breakdown breakdown

Returned by: douyin.xingtu.creators.followers.get、douyin.xingtu.creators.audience.get、douyin.xingtu.creators.content_mix.get、xiaohongshu.pgy.creators.followers.get、douyin.index.keywords.audience.get、douyin.index.creators.audience.get

Field Type Description
platform string Platform
dimension string Dimension: gender, age, province, city, city_tier, device, interest, crowd (consumer groups) or content
title string | null The platform's name for it, such as 年龄分布
summary string | null The one-line summary the platform gives
items {label, value, share, tgi}[] Count, share (0–1) and TGI (100 is average, above means stronger preference; Ocean Engine only) per item, largest first

Stats stats

Returned by: douyin.xingtu.creators.metrics、douyin.xingtu.creators.costs.get、xiaohongshu.pgy.creators.metrics、xiaohongshu.pgy.creators.performance、xiaohongshu.pgy.creators.costs.history、xiaohongshu.pgy.creators.followers.metrics、xiaohongshu.pgy.creators.followers.history、xiaohongshu.pgy.keywords.metrics、xiaohongshu.pgy.keywords.history、douyin.index.keywords.history、douyin.index.creators.metrics、douyin.users.history、wechat.index.history

Field Type Description
platform string Platform
subject_id string Whose figures these are: creator ID or keyword
period string | null Period covered; for day-by-day lists, the day (YYYY-MM-DD)
metrics object The figures, named on each endpoint page; rates are 0–1 and money is CNY

Transcript transcript

Returned by: youtube.videos.transcript.get、tiktok.videos.transcript.get、instagram.posts.transcript.get、x.posts.transcript.get、linkedin.posts.transcript.get、reddit.posts.transcript.get、meta.ads.transcript.get

Field Type Description
id string The video or post ID, as the platform’s detail endpoint takes it
platform string Platform
url string | null Video or post link
language string | null Caption language (when the platform says)
text string The full transcript
segments {start, end, text}[] Timed segments in seconds (YouTube, TikTok, Instagram and Reddit; empty elsewhere)
duration_seconds number | null Video length in seconds
source 'captions' | 'ai' | null captions (the platform’s own), ai (AI transcription) or null (not known)

Article stats article_stats

Returned by: wechat_mp.articles.stats

Field Type Description
platform string Platform
url string Article link
reads number | null Reads
likes number | null Likes
wows number | null "Wow" count
shares number | null Shares
favorites number | null Saves
comments number | null Comments