Account object

36 endpoints on 17 platforms return the Account object with the same 11 fields, so code written for one platform reads the others unchanged. A call costs $0.0004 to $0.0400.

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

An Account is a user, a channel, a page or an official account on a platform: handle, display name, bio, and its counts of followers, following and posts. Profiles, user searches and the lists of followers, likers, retweeters and members all return it.

The author of a post or a comment points to an account by its id and username. A creator on Xingtu (星图) or PGY (蒲公英) is a separate object, Creator, which points to its account with account_id.

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

username text

Handle

name text

Display name

url link

Link to the profile

bio text

Bio

avatar_url link standard

Avatar

verified yes/no standard

Whether the account is verified

created_at time standard

When the account was created

metrics object

Account counts

metrics.followers integer

Followers

metrics.following integer

Following

metrics.posts integer

Posts published

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
created_atThe day the page was created; no time of dayFacebook
metrics.followersSubscribers, which the platform shows to three significant figuresYouTube
People who follow the page; from a thousand up the platform gives a rounded figureFacebook
SubscribersTelegram
metrics.postsVideosYouTube
Videos uploadedBilibili

What a platform cannot give

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

FieldNot available on
idTelegram
usernameWeChat Official AccountsWeChat ChannelsWeibo
urlWeChat Official AccountsWeChat ChannelsKuaishou
bioWeChat Official Accounts
avatar_urlWeChat Official Accounts
verifiedFacebookWeChat Official AccountsWeChat ChannelsLinkedInZhihu
created_atInstagramDouyinXiaohongshu (RedNote)WeChat Official AccountsWeChat ChannelsBilibiliLinkedInThreadsKuaishouZhihuTelegram
metrics.followersRedditWeChat Official AccountsWeChat ChannelsLinkedIn
metrics.followingYouTubeRedditFacebookWeChat Official AccountsWeChat ChannelsLinkedInThreadsZhihuTelegram
metrics.postsInstagramFacebookWeChat Official AccountsLinkedInThreadsZhihuTelegram
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 Account

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

EndpointPathPrice
TikTok user profileGET/v1/tiktok/users/get$0.0020
TikTok user searchGET/v1/tiktok/users/search$0.0020
TikTok user followersGET/v1/tiktok/users/followers/list$0.0020
YouTube channel profileGET/v1/youtube/channels/get$0.0020
YouTube channel searchGET/v1/youtube/channels/search$0.0020
Instagram user profileGET/v1/instagram/users/get$0.0020
Instagram user searchGET/v1/instagram/users/search$0.0040
X post retweetersGET/v1/x/posts/retweeters/list$0.0020
X user followersGET/v1/x/users/followers/list$0.0001 / item
X user followingGET/v1/x/users/following/list$0.0001 / item
X user profileGET/v1/x/users/get$0.0004 / item
X user searchGET/v1/x/users/search$0.0004 / item
X community membersGET/v1/x/communities/members/list$0.0004 / item
X list followersGET/v1/x/lists/followers/list$0.0004 / item
X list membersGET/v1/x/lists/members/list$0.0004 / item
Douyin user profileGET/v1/douyin/users/get$0.0020
Douyin user searchGET/v1/douyin/users/search$0.0020
Xiaohongshu user profileGET/v1/xiaohongshu/users/get$0.0200
Xiaohongshu user searchGET/v1/xiaohongshu/users/search$0.0200
Reddit user profileGET/v1/reddit/users/get$0.0020
Facebook page profileGET/v1/facebook/pages/get$0.0020
WeChat Official Account profileGET/v1/wechat_mp/accounts/get$0.0200
WeChat Channels account profileGET/v1/wechat_channels/users/get$0.0200
Bilibili user profileGET/v1/bilibili/users/get$0.0020
Weibo post likersGET/v1/weibo/posts/likers/list$0.0020
Weibo user followersGET/v1/weibo/users/followers/list$0.0020
Weibo user profileGET/v1/weibo/users/get$0.0020
Weibo user searchGET/v1/weibo/users/search$0.0020
LinkedIn company pageGET/v1/linkedin/companies/get$0.0020
Threads user profileGET/v1/threads/users/get$0.0020
Kuaishou user profileGET/v1/kuaishou/users/get$0.0200
Kuaishou user searchGET/v1/kuaishou/users/search$0.0200
Zhihu user followersGET/v1/zhihu/users/followers/list$0.0020
Zhihu user profileGET/v1/zhihu/users/get$0.0020
Zhihu user searchGET/v1/zhihu/users/search$0.0020
Telegram channel profileGET/v1/telegram/channels/get$0.0020

Example

One item from tiktok.users.get, as recorded 2026-10-12 19:16 UTC. Names, text, IDs and links are examples; the figures are as recorded.

Account · tiktok.users.get
{
  "id": "6150517320383571107",
  "username": "northside_coffee",
  "name": "Leo Park",
  "url": "https://www.tiktok.com/@northside_coffee",
  "bio": "Gear reviews, no sponsors. New video every Friday.",
  "avatar_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f299fd71765268c38f7d~c5_100x100.jpeg",
  "verified": true,
  "created_at": "2019-12-16T22:13:53.000Z",
  "metrics": { "followers": 605660, "following": 92, "posts": 364 }
}

The whole response is on the endpoint's page →

Related

Other objects