Post object

81 endpoints on 19 platforms return the Post object with the same 28 fields, so code written for one platform reads the others unchanged. A call costs $0.0003 to $0.0200.

Stable object · Updated 2026-10-17Open in ChatGPT Open in Claude

For machinespost schema openapi.json Object table (JSON)Markdown llms.txt

A Post is one piece of published content: a video, a note, a tweet, an article, a message in a channel. Every platform's posts come back with the same fields, so text, author, published_at and the likes in metrics sit in the same place on Douyin and on YouTube.

A post's author is the account that published it, with its id and username; comments under it point back with post_id, and so does the transcript of a video post. On X (Twitter) a reply is itself a post, and its post_id, parent_id and root_id say which thread it hangs in.

Fields

A field the platform cannot give is left out of the item and named in meta.unavailable. It is never filled with a guess or a zero.

id text

ID; pass it unchanged to the get endpoint

url link

Link that opens the post

type text

Content format: video image text article

title text

Title

text text

Body text

lang text standard

Language of the text

published_at time

When it was published

author object

Author

author.id text

Author's account ID

author.username text

Author's handle

author.name text

Author's display name

author.avatar_url link standard

Author's avatar

author.verified yes/no standard

Whether the author is verified

author.followers integer standard

Author's follower count

metrics object

Engagement counts

metrics.likes integer

Likes

metrics.comments integer

Comments

metrics.shares integer

metrics.favorites integer

Saves

metrics.views integer

Views

metrics.reposts integer

Reposts

images list of link standard

Image addresses

hashtags list of text standard

Hashtags, without the #

mentions list of object standard

Accounts mentioned in the text

mentions[].id text standard

Account ID

mentions[].username text standard

Handle

mentions[].name text standard

Display name

is_pinned yes/no standard

Whether the author pinned it

post_id text

ID of the thread's root post when this is a reply; otherwise null

parent_id text

ID of the item it replies to directly; otherwise null

root_id text

ID of the first-level reply its thread hangs under

Where each number comes from

The same field name does not always mean the same act on every platform. This table says which of the platform's own numbers goes into the field.

FieldWhat it holds thereOn

idMade of the __biz, mid and idx of the article's long link; an article is fetched by its url, not by thisWeChat Official Accounts

Made of the __biz, mid and idx of the long link givenWeChat Official Accounts

The encrypted ID WeChat Search gives the video (starting with export/), as given: not the numeric ID the Channels video and comment endpoints take, and not promised to be the same for the same video in a later searchWeChat Channels

An article: made of the __biz, mid and idx of its long link, the same as the Official Account article list gives, and an article is fetched by its url; a video: the encrypted ID WeChat Search gives it (starting with export/), as given, not the numeric ID the Channels video endpoint takes, and not promised to be the same for the same video in a later searchWeChat Search

The channel's handle and the message's number, as in telegram/401; pass it unchanged to the message endpointTelegram

urlThe author's profile page opened on this videoDouyin

The article's link; a Channels video has no web link, so nullWeChat Search

typevideo for a post that carries a video, image for one with pictures only, text otherwiseYouTube

titleThe title as the result card shows it, without emojiXiaohongshu (RedNote)

The article's title, without the keyword highlighting; a video has no title apart from its description, so nullWeChat Search

textThe video's descriptionYouTube

The excerpt the result card shows, not the whole text; the note itself has all of itXiaohongshu (RedNote)

The first 100 characters of the text; the note itself has all of itXiaohongshu (RedNote)

The article's digest, not its whole textWeChat Official Accounts

The video's description, without the keyword highlightingWeChat Channels

An article's digest (not its whole text) or a video's description, without the keyword highlightingWeChat Search

The pin's descriptionPinterest

published_atThe platform gives the day of publication only (a calendar day in China time), written as midnight UTC of that date: not the moment it was publishedDouyin

author.usernameHandle of the channel the message is inTelegram

author.nameThe account's name; WeChat Search gives no account IDWeChat Channels

The name of the Official Account or Channels account; WeChat Search gives no account IDWeChat Search

author.avatar_urlThe Channels account's avatar; an article's result has none, so nullWeChat Search

author.verifiedWhether whoever pinned it carries the platform's verified mark; null when it does notPinterest

author.followersThe author's follower countLinkedIn

metrics.likesLikes; from a thousand up the platform shows a rounded numberYouTube

All reactions together (like, love, haha and the rest)Facebook

The likes the card shows; one written like 1.4万 is approximate and 10万+ a lower bound; null when the card shows no countWeChat Channels

The likes a video's card shows, one written like 1.4万 approximate and 10万+ a lower bound, null when the card shows no count; an article's result has no counts, so nullWeChat Search

All reactions together (like, celebrate, support and the rest)LinkedIn

UpvotesZhihu

All reactions togetherPinterest

metrics.commentsRepliesX (Twitter)

Direct repliesThreads

Comments on the content, other people's copies of the pin includedPinterest

metrics.sharesTimes it was shared (sent on)Threads

metrics.favoritesBookmarksX (Twitter)

The card's other count, the same count as the saves of the Channels video lists; approximate, lower bound and null as for likesWeChat Channels

A video card's other count, the same count as the saves of the Channels video lists, approximate, lower bound and null as for likes; null for an articleWeChat Search

Times this pin was saved on; the total for the same content is in ext.savesPinterest

metrics.viewsViews of the video; null on a post that is not a videoFacebook

Reads; above 100,000 the platform says only "100k+", and this is a lower boundWeChat Official Accounts

Views; the popular order sorts by itBilibili

Reads; null on a post that shows no read countWeibo

Views; from a thousand up the platform shows a rounded numberTelegram

metrics.repostsRetweets; quotes are counted apart, in ext.quotesX (Twitter)

RepostsWeiboZhihu

Reposts; quotes are counted apart, in ext.quotesThreads

imagesThe video's coverYouTube

The one picture the search matched, at its full size; the address expires. The note's other pictures come with the note itselfXiaohongshu (RedNote)

The pin's picture at full sizePinterest

hashtagsThe post's topic tag; a post has at most oneThreads

is_pinnedWhether it is pinned on the profile asked forInstagram

post_idID of the conversation's root postX (Twitter)

What a platform cannot give

A platform stands against a field when none of its endpoints gives it.

FieldNot available on

urlWeChat Channels

typeLinkedInKuaishou

titleTikTokInstagramFacebookWeChat ChannelsWeiboLinkedInThreadsKuaishouTelegram

langYouTubeInstagramFacebookWeChat Official AccountsWeChat ChannelsWeChat SearchBilibiliWeiboLinkedInKuaishouZhihuTelegramPinterest

author.idWeChat SearchLinkedInTelegram

author.usernameWeChat ChannelsWeChat SearchBilibiliWeibo

author.nameReddit

author.avatar_urlTelegram

author.verifiedTikTokYouTubeDouyinRedditWeChat Official AccountsWeChat ChannelsWeChat SearchLinkedInZhihuTelegram

author.followersYouTubeInstagramXiaohongshu (RedNote)RedditFacebookWeChat Official AccountsWeChat ChannelsWeChat SearchThreadsKuaishouTelegram

metrics.likesRedditTelegram

metrics.commentsWeChat SearchTelegram

metrics.sharesYouTubeInstagramX (Twitter)WeChat SearchWeiboLinkedInZhihuTelegram

metrics.favoritesYouTubeInstagramRedditFacebookWeiboLinkedInThreadsTelegram

metrics.viewsXiaohongshu (RedNote)RedditWeChat ChannelsWeChat SearchLinkedInPinterest

metrics.repostsTikTokYouTubeInstagramDouyinXiaohongshu (RedNote)RedditFacebookWeChat Official AccountsWeChat ChannelsWeChat SearchBilibiliLinkedInKuaishouTelegramPinterest

imagesTikTokWeChat Official AccountsWeChat ChannelsWeChat SearchBilibiliKuaishou

hashtagsYouTubeInstagramRedditFacebookWeChat Official AccountsWeChat ChannelsWeChat SearchLinkedInKuaishouZhihuTelegramPinterest

mentions[].idYouTubeInstagramDouyinRedditFacebookWeChat Official AccountsWeChat ChannelsWeChat SearchBilibiliWeiboLinkedInThreadsKuaishouZhihuTelegramPinterest

mentions[].usernameTikTokYouTubeInstagramDouyinXiaohongshu (RedNote)RedditFacebookWeChat Official AccountsWeChat ChannelsWeChat SearchBilibiliWeiboLinkedInThreadsKuaishouZhihuTelegramPinterest

mentions[].nameTikTokYouTubeInstagramDouyinRedditFacebookWeChat Official AccountsWeChat ChannelsWeChat SearchBilibiliWeiboLinkedInThreadsKuaishouZhihuTelegramPinterest

is_pinnedYouTubeX (Twitter)FacebookWeChat Official AccountsWeChat ChannelsWeChat SearchBilibiliLinkedInKuaishouTelegramPinterest

post_idTikTokYouTubeInstagramDouyinXiaohongshu (RedNote)RedditFacebookWeChat Official AccountsWeChat ChannelsWeChat SearchBilibiliWeiboLinkedInThreadsKuaishouTelegramPinterest

parent_idTikTokYouTubeInstagramDouyinXiaohongshu (RedNote)RedditFacebookWeChat Official AccountsWeChat ChannelsWeChat SearchBilibiliWeiboLinkedInThreadsKuaishouTelegramPinterest

root_idTikTokYouTubeInstagramX (Twitter)DouyinXiaohongshu (RedNote)RedditFacebookWeChat Official AccountsWeChat ChannelsWeChat SearchBilibiliWeiboLinkedInThreadsKuaishouZhihuTelegramPinterest

One endpoint may still leave out a field another gives: each endpoint's page lists what it cannot give, and every answer says so in meta.unavailable.

Endpoints that return Post

The number beside each platform is how many of its endpoints return it.

TikTok4 YouTube5 Instagram3 X (Twitter)10 Douyin9 Xiaohongshu (RedNote)5 Reddit5 Facebook2 WeChat Official Accounts3 WeChat Channels4 WeChat Search1 Bilibili4 Weibo3 LinkedIn3 Threads3 Kuaishou3 Zhihu10 Telegram2 Pinterest2

EndpointPathPrice

TikTok4

TikTok hashtag videosGET/v1/tiktok/hashtags/videos/list$0.0020

TikTok user videosGET/v1/tiktok/users/videos/list$0.0020

TikTok video detailGET/v1/tiktok/videos/get$0.0020

TikTok video searchGET/v1/tiktok/videos/search$0.0020

YouTube5

YouTube channel videosGET/v1/youtube/channels/videos/list$0.0020

YouTube video detailGET/v1/youtube/videos/get$0.0020

YouTube video searchGET/v1/youtube/videos/search$0.0020

YouTube channel postsGET/v1/youtube/channels/posts/list$0.0020

YouTube post detailGET/v1/youtube/posts/get$0.0020

Instagram3

Instagram hashtag postsGET/v1/instagram/hashtags/posts/list$0.0020

Instagram post detailGET/v1/instagram/posts/get$0.0020

Instagram user postsGET/v1/instagram/users/posts/list$0.0020

X (Twitter)10

X community postsGET/v1/x/communities/posts/list$0.0003 / item

X list postsGET/v1/x/lists/posts/list$0.0020

X article detailGET/v1/x/posts/article/get$0.0020

X post detailGET/v1/x/posts/get$0.0003

X post quotesGET/v1/x/posts/quotes/list$0.0003 / item

X post repliesGET/v1/x/posts/replies/list$0.0020

X post searchGET/v1/x/posts/search$0.0020

X thread contextGET/v1/x/threads/posts/list$0.0003 / item

X user mentionsGET/v1/x/users/mentions/list$0.0003 / item

X user postsGET/v1/x/users/posts/list$0.0020

Douyin9

Douyin hashtag videosGET/v1/douyin/hashtags/videos/list$0.0020

Douyin trend-index creator top videosGET/v1/douyin/index/creators/videos/list$0.0020

Douyin trend-index keyword hot videosGET/v1/douyin/index/videos/search$0.0020

Douyin user videosGET/v1/douyin/users/videos/list$0.0020

Douyin video detailGET/v1/douyin/videos/get$0.0020

Douyin video play countGET/v1/douyin/videos/metrics$0.0020

Douyin related videosGET/v1/douyin/videos/related$0.0020

Douyin video searchGET/v1/douyin/videos/search$0.0200

Douyin trending videosGET/v1/douyin/videos/trending$0.0020

Xiaohongshu (RedNote)5

Xiaohongshu image searchGET/v1/xiaohongshu/images/search$0.0200

Xiaohongshu note detailGET/v1/xiaohongshu/notes/get$0.0200

Xiaohongshu note searchGET/v1/xiaohongshu/notes/search$0.0200

Xiaohongshu topic notesGET/v1/xiaohongshu/topics/notes/list$0.0200

Xiaohongshu user notesGET/v1/xiaohongshu/users/notes/list$0.0200

Reddit5

Reddit post detailGET/v1/reddit/posts/get$0.0020

Reddit post searchGET/v1/reddit/posts/search$0.0020

Reddit popular postsGET/v1/reddit/posts/trending$0.0020

Reddit community postsGET/v1/reddit/subreddits/posts/list$0.0020

Reddit user postsGET/v1/reddit/users/posts/list$0.0020

Facebook2

Facebook page postsGET/v1/facebook/pages/posts/list$0.0020

Facebook post detailGET/v1/facebook/posts/get$0.0020

WeChat Official Accounts3

WeChat Official Account articlesGET/v1/wechat_mp/accounts/articles/list$0.0200

WeChat Official Account article detailGET/v1/wechat_mp/articles/get$0.0200

WeChat Official Account article statsGET/v1/wechat_mp/articles/metrics$0.0200

WeChat Channels4

WeChat Channels video detailGET/v1/wechat_channels/videos/get$0.0200

WeChat Channels collection videosGET/v1/wechat_channels/collections/videos/list$0.0200

WeChat Channels account videosGET/v1/wechat_channels/users/videos/list$0.0200

WeChat Channels video searchGET/v1/wechat_channels/videos/search$0.0200

WeChat Search1

WeChat Search articles and videosGET/v1/wechat/posts/search$0.0200

Bilibili4

Bilibili user videosGET/v1/bilibili/users/videos/list$0.0020

Bilibili video detailGET/v1/bilibili/videos/get$0.0020

Bilibili video searchGET/v1/bilibili/videos/search$0.0020

Bilibili popular videosGET/v1/bilibili/videos/trending$0.0020

Weibo3

Weibo post detailGET/v1/weibo/posts/get$0.0020

Weibo realtime searchGET/v1/weibo/posts/search$0.0020

Weibo user postsGET/v1/weibo/users/posts/list$0.0020

LinkedIn3

LinkedIn company postsGET/v1/linkedin/companies/posts/list$0.0020

LinkedIn post detailGET/v1/linkedin/posts/get$0.0020

LinkedIn post searchGET/v1/linkedin/posts/search$0.0020

Threads3

Threads post detailGET/v1/threads/posts/get$0.0020

Threads post searchGET/v1/threads/posts/search$0.0020

Threads user postsGET/v1/threads/users/posts/list$0.0020

Kuaishou3

Kuaishou user videosGET/v1/kuaishou/users/videos/list$0.0200

Kuaishou video detailGET/v1/kuaishou/videos/get$0.0020

Kuaishou video searchGET/v1/kuaishou/videos/search$0.0200

Zhihu10

Zhihu answer detailGET/v1/zhihu/answers/get$0.0020

Zhihu article detailGET/v1/zhihu/articles/get$0.0020

Zhihu column articlesGET/v1/zhihu/columns/articles/list$0.0020

Zhihu pin detailGET/v1/zhihu/pins/get$0.0020

Zhihu content searchGET/v1/zhihu/posts/search$0.0020

Zhihu question answersGET/v1/zhihu/questions/answers/list$0.0020

Zhihu question detailGET/v1/zhihu/questions/get$0.0020

Zhihu user answersGET/v1/zhihu/users/answers/list$0.0020

Zhihu user articlesGET/v1/zhihu/users/articles/list$0.0020

Zhihu user pinsGET/v1/zhihu/users/pins/list$0.0020

Telegram2

Telegram channel messagesGET/v1/telegram/channels/messages/list$0.0020

Telegram message detailGET/v1/telegram/messages/get$0.0020

Pinterest2

Pinterest pin detailGET/v1/pinterest/pins/get$0.0020

Pinterest pin searchGET/v1/pinterest/pins/search$0.0020

Example

One item from tiktok.hashtags.videos.list, as recorded 2026-10-12 18:47 UTC. Names, text, IDs and links are examples; the figures are as recorded.

Post · tiktok.hashtags.videos.list

{
  "id": "7324847345040857368",
  "url": "https://www.tiktok.com/@hannah.w.photo/video/7324847345040857368",
  "type": "video",
  "text": "Weekend hiking from last night, no filter. Settings in the comments.",
  "lang": "en",
  "published_at": "2026-10-06T15:16:22.000Z",
  "author": {
    "id": "6049772375495468810",
    "username": "hannah.w.photo",
    "name": "Hannah Weiss",
    "avatar_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/523134e9dfaaa0b34294~c5_100x100.jpeg"
  },
  "metrics": {
    "likes": 10289,
    "comments": 101,
    "shares": 364,
    "favorites": 852,
    "views": 86424
  },
  "hashtags": [
    "outdoors",
    "weekendvibes",
    // … 3 more
  ],
  "mentions": []
}

The whole response is on the endpoint's page →

Post object

Fields

Where each number comes from

What a platform cannot give

Endpoints that return Post

Example

Related

Post detail API

Account posts API

All endpoints

Other objects