DataNavoAPI / DOCS

Post fields and sources

Post fields and sources. Follow concrete contracts, examples and reviewable steps using Douyin, Bilibili, Kuaishou, Telegram.

LOCAL SIMULATIONAll displayed records are fictional fixtures. Live APIs, payments and external email are disabled.中文版 ↗
01

Object and null semantics

Post (post) is referenced by 92 capabilities across 19 platforms. Shared names help organize records; they do not guarantee identical data coverage.

Preserve identifiers as strings. Null, absent, zero and empty arrays mean different things. Fields under ext are platform extensions, not universal guarantees.

02

Complete field paths

Field facts come from the preserved public contracts. The table merges platform extensions and identifies the platforms whose contracts declare each field.

Field pathTypeRequirementDeclaring platforms
idstring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
urlstring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
typestring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
titlestring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
textstring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
langstring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
published_atstring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
authorobject | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
author.idstring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
author.usernamestring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
author.namestring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
author.avatar_urlstring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
author.verifiedboolean | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
author.followersinteger | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
metricsobject | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
metrics.likesinteger | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
metrics.commentsinteger | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
metrics.sharesinteger | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
metrics.favoritesinteger | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
metrics.viewsinteger | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
metrics.repostsinteger | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
imagesarray | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
hashtagsarray | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
mentionsarray | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
mentions[].idstring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
mentions[].usernamestring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
mentions[].namestring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
is_pinnedboolean | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
post_idstring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
parent_idstring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
root_idstring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
approximatearray | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
approximate[].fieldstring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
approximate[].kindstring | nullOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
extobjectOptional in contractDouyin, Bilibili, Kuaishou, Telegram, X (Twitter), Facebook, LinkedIn, Threads, Instagram, TikTok, Weibo, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, WeChat Official Accounts, Reddit, Zhihu, Pinterest
ext.aidstring | nullOptional in contractBilibili
ext.coinsinteger | nullOptional in contractBilibili
ext.danmakuinteger | nullOptional in contractBilibili
ext.durationnumber | nullOptional in contractBilibili, Douyin, Kuaishou, Instagram, TikTok, Xiaohongshu (RedNote), YouTube, WeChat Channels, WeChat Search, Pinterest
ext.cover_urlstring | nullOptional in contractBilibili, Douyin, TikTok, Xiaohongshu (RedNote), WeChat Channels, WeChat Search, WeChat Official Accounts
ext.categorystring | nullOptional in contractBilibili, Douyin, YouTube
ext.ip_locationstring | nullOptional in contractBilibili, Weibo, Xiaohongshu (RedNote), WeChat Official Accounts
ext.cidstring | nullOptional in contractBilibili
ext.partsinteger | nullOptional in contractBilibili
ext.recommend_reasonstring | nullOptional in contractBilibili
ext.new_followersinteger | nullOptional in contractDouyin
ext.like_ratenumber | nullOptional in contractDouyin
ext.follow_ratenumber | nullOptional in contractDouyin
ext.indexinteger | nullOptional in contractDouyin
ext.video_urlstring | nullOptional in contractDouyin, Instagram, TikTok, Xiaohongshu (RedNote), WeChat Channels
ext.finish_ratenumber | nullOptional in contractDouyin
ext.interaction_ratenumber | nullOptional in contractDouyin
ext.categoriesarray | nullOptional in contractDouyin
ext.author_xingtu_idstring | nullOptional in contractDouyin
ext.author_uidstring | nullOptional in contractDouyin
ext.numberinteger | nullOptional in contractTelegram
ext.quotesinteger | nullOptional in contractX (Twitter), Threads
ext.quoted_idstring | nullOptional in contractX (Twitter)
ext.is_retweetboolean | nullOptional in contractX (Twitter)
ext.retweeted_idstring | nullOptional in contractX (Twitter)
ext.retweeted_author_idstring | nullOptional in contractX (Twitter)
ext.media_idstring | nullOptional in contractThreads, Instagram
ext.collaboratorsarray | nullOptional in contractInstagram, TikTok
ext.text_truncatedboolean | nullOptional in contractWeibo
ext.reposted_idstring | nullOptional in contractWeibo
ext.subtitle_urlstring | nullOptional in contractXiaohongshu (RedNote)
ext.is_sponsoredboolean | nullOptional in contractXiaohongshu (RedNote)
ext.video_idstring | nullOptional in contractYouTube
ext.keywordsarray | nullOptional in contractYouTube
ext.chaptersarray | nullOptional in contractYouTube
ext.chapters[].titlestring | nullOptional in contractYouTube
ext.chapters[].startnumber | nullOptional in contractYouTube
ext.decode_keystring | nullOptional in contractWeChat Channels
ext.counted_atstring | nullOptional in contractWeChat Channels
ext.reads_labelstring | nullOptional in contractWeChat Search
ext.recommendsinteger | nullOptional in contractWeChat Official Accounts
ext.positioninteger | nullOptional in contractWeChat Official Accounts
ext.content_typestring | nullOptional in contractWeChat Official Accounts
ext.digeststring | nullOptional in contractWeChat Official Accounts
ext.bylinestring | nullOptional in contractWeChat Official Accounts
ext.source_urlstring | nullOptional in contractWeChat Official Accounts
ext.scoreinteger | nullOptional in contractReddit
ext.upvote_rationumber | nullOptional in contractReddit
ext.subredditstring | nullOptional in contractReddit
ext.linkstring | nullOptional in contractReddit, Pinterest
ext.nsfwboolean | nullOptional in contractReddit
ext.answersinteger | nullOptional in contractZhihu
ext.followersinteger | nullOptional in contractZhihu
ext.savesinteger | nullOptional in contractPinterest
03

Capabilities returning this object

CapabilityObjectShapePagination
douyin.hashtags.videos.listPostitemsExplicit cursor
bilibili.users.videos.listPostitemsExplicit cursor
bilibili.videos.getPostitemNo cursor
bilibili.videos.searchPostitemsExplicit cursor
bilibili.videos.trendingPostitemsExplicit cursor
douyin.index.creators.videos.listPostitemsNo cursor
douyin.index.videos.searchPostitemsNo cursor
douyin.users.videos.listPostitemsExplicit cursor
douyin.videos.getPostitemNo cursor
douyin.videos.metricsPostitemNo cursor
douyin.videos.relatedPostitemsNo cursor
douyin.videos.searchPostitemsExplicit cursor
douyin.videos.trendingPostitemsExplicit cursor
kuaishou.users.videos.listPostitemsExplicit cursor
kuaishou.videos.getPostitemNo cursor
kuaishou.videos.searchPostitemsExplicit cursor
telegram.channels.messages.listPostitemsExplicit cursor
telegram.messages.getPostitemNo cursor
x.communities.posts.listPostitemsExplicit cursor
x.lists.posts.listPostitemsExplicit cursor
x.posts.article.getPostitemNo cursor
x.posts.getPostitemNo cursor
facebook.pages.posts.listPostitemsExplicit cursor
facebook.posts.getPostitemNo cursor
linkedin.companies.posts.listPostitemsNo cursor
linkedin.posts.getPostitemNo cursor
linkedin.posts.searchPostitemsExplicit cursor
threads.posts.getPostitemNo cursor
threads.posts.searchPostitemsNo cursor
threads.users.posts.listPostitemsNo cursor
instagram.hashtags.posts.listPostitemsExplicit cursor
instagram.posts.getPostitemNo cursor
instagram.users.posts.listPostitemsExplicit cursor
tiktok.hashtags.videos.listPostitemsExplicit cursor
tiktok.users.videos.listPostitemsExplicit cursor
tiktok.videos.getPostitemNo cursor
tiktok.videos.searchPostitemsExplicit cursor
weibo.posts.getPostitemNo cursor
weibo.posts.searchPostitemsExplicit cursor
weibo.users.posts.listPostitemsExplicit cursor
x.posts.quotes.listPostitemsExplicit cursor
x.posts.replies.listPostitemsExplicit cursor
x.posts.searchPostitemsExplicit cursor
x.threads.posts.listPostitemsExplicit cursor
x.users.mentions.listPostitemsExplicit cursor
x.users.posts.listPostitemsExplicit cursor
xiaohongshu.images.searchPostitemsExplicit cursor
xiaohongshu.notes.getPostitemNo cursor
xiaohongshu.notes.searchPostitemsExplicit cursor
xiaohongshu.topics.notes.listPostitemsNo cursor
xiaohongshu.users.notes.listPostitemsExplicit cursor
youtube.channels.videos.listPostitemsExplicit cursor
youtube.videos.getPostitemNo cursor
youtube.videos.searchPostitemsExplicit cursor
wechat_channels.videos.getPostitemNo cursor
wechat_channels.collections.videos.listPostitemsExplicit cursor
wechat_channels.users.videos.listPostitemsExplicit cursor
wechat_channels.videos.searchPostitemsExplicit cursor
wechat.posts.searchPostitemsExplicit cursor
wechat_mp.accounts.articles.listPostitemsExplicit cursor
wechat_mp.articles.getPostitemNo cursor
wechat_mp.articles.metricsPostitemNo cursor
wechat_channels.backup.users.videos.listPostitemsExplicit cursor
wechat.backup.posts.searchPostitemsExplicit cursor
wechat_channels.backup.videos.searchPostitemsExplicit cursor
wechat_channels.videos.metricsPostitemNo cursor
wechat_channels.users.live_replays.listPostitemsNo cursor
reddit.posts.getPostitemNo cursor
reddit.posts.searchPostitemsExplicit cursor
reddit.posts.trendingPostitemsExplicit cursor
reddit.subreddits.posts.listPostitemsExplicit cursor
reddit.users.posts.listPostitemsExplicit cursor
zhihu.answers.getPostitemNo cursor
zhihu.articles.getPostitemNo cursor
zhihu.columns.articles.listPostitemsExplicit cursor
zhihu.pins.getPostitemNo cursor
zhihu.posts.searchPostitemsExplicit cursor
zhihu.questions.answers.listPostitemsNo cursor
zhihu.questions.getPostitemNo cursor
zhihu.users.answers.listPostitemsExplicit cursor
zhihu.users.articles.listPostitemsExplicit cursor
zhihu.users.pins.listPostitemsExplicit cursor
youtube.channels.posts.listPostitemsExplicit cursor
youtube.posts.getPostitemNo cursor
pinterest.pins.getPostitemNo cursor
pinterest.pins.searchPostitemsExplicit cursor
douyin.xingtu.videos.getPostitemNo cursor
xiaohongshu.videos.getPostitemNo cursor
xiaohongshu.pgy.notes.trendingPostitemsExplicit cursor
bilibili.backup.users.videos.listPostitemsExplicit cursor
douyin.backup.users.videos.listPostitemsExplicit cursor
douyin.backup.videos.searchPostitemsExplicit cursor
TRY THE CONTRACT

Clear inputs. Inspectable output.

Each click runs a local fixture. Advanced JSON inputs are checked against the selected method. Editing does not execute a request.

Copying does not execute. CLI quote is read-only and needs a local customer TEST key. Configure MCP in demo mode first. GET and POST batches both return only fictional local fixtures.

Download contract example (no execution) ↗

For TEST budgets, Key scopes or failure scenarios, open the account console. Customer sandbox ↗