Object

Post object

A video, note, tweet or article, the same shape on every platform. The same fields on every platform. A field a platform does not show is null, and meta.unavailable names it with the reason.

Field	Type	Description
`id`	string	Post ID on the platform.
`url`	string	Link to the post.
`type`	string	What kind of post it is.
`title`	string \| null	Title, where the platform has one (videos, notes, articles).
`text`	string	Caption, body or description as plain text; articles come as Markdown.
`lang`	string \| null	Language code, as reported or detected.
`published_at`	string	When it was published, ISO 8601 in UTC.
`author`	AccountRef	Who posted it.
`metrics`	Metrics	Counts at fetch time; a count the platform hides is null.
`images`	string[] \| null	Image URLs for image posts and notes.
`hashtags`	string[] \| null	Hashtags or topics, without the # sign.
`ext`	object	Platform-specific extras. Only returned with view=full. · only with view=full

AccountRef

Field	Type	Description
`id`	string	Account ID on the platform.
`username`	string \| null	Handle, where the platform has one.
`name`	string \| null	Display name.
`avatar_url`	string \| null	Avatar image URL.
`followers`	integer \| null	Follower count at fetch time.
`verified`	boolean \| null	Whether the platform shows a verification badge.

Metrics

Field	Type	Description
`views`	integer \| null	Views or plays.
`likes`	integer \| null	Likes.
`comments`	integer \| null	Comments.
`shares`	integer \| null	Shares.
`favorites`	integer \| null	Saves or favorites.
`reposts`	integer \| null	Reposts, retweets or forwards.

Example · douyin

{
  "id": "7436185237401447690",
  "url": "https://www.douyin.com/video/7436185237401447690",
  "type": "video",
  "title": null,
  "text": "两晚山里露营，装备清单都在这了 #露营 #户外装备",
  "lang": "zh",
  "published_at": "2026-11-02T09:30:00Z",
  "author": {
    "id": "MS4wLjABAAAAq8Xw2mKpT0",
    "username": "qingzhuang_tubu",
    "name": "轻装徒步",
    "avatar_url": "https://cdn.example.com/avatar/trailkit.jpg",
    "followers": 182300,
    "verified": true
  },
  "metrics": {
    "views": null,
    "likes": 48200,
    "comments": 1312,
    "shares": 2210,
    "favorites": 9650,
    "reposts": null
  },
  "images": null,
  "hashtags": [
    "露营",
    "户外装备"
  ]
}

AccountRef

Metrics

Endpoints that return a Post