Profile API for Instagram, Rumble, Threads, TikTok and YouTube: the profile schema

Endpoints

5 endpoints return profiles on Instagram, Rumble, Threads, TikTok and YouTube.

Schema

Every endpoint above returns this object as data. The standard meta comes with every response.

Field	Type	Description
`platform`	`string`	Platform ID (tiktok, youtube, …).
`id`	`string`	Platform-native account ID (string; YouTube UC…, Reddit without t2_).
`username`	`string` or `null`	Handle without the @; null when the account has none.
`display_name`	`string` or `null`	Display name, channel title or page name; null when empty or not exposed.
`url`	`string` (uri)	Canonical profile URL.
`type`	`string`	Coarse account kind, as the platform labels it; unknown when it does not (TikTok labels organizations only). New values may be added; treat unknown values as unknown. One of `person`, `organization`, `community`, `unknown`
`bio`	`string` or `null`	Profile bio, channel description or page about text; null when empty or not exposed.
`avatar_url`	`string` (uri) or `null`	Profile picture URL (largest available). Platform CDN URLs can expire within hours.
`banner_url`	`string` (uri) or `null`	Header or cover image URL.
`is_verified`	`boolean` or `null`	Platform verification badge; null where the platform has no badge.
`is_private`	`boolean` or `null`	True when the account's posts are not public.
`category`	`string` or `null`	Platform category label (e.g. Musician, Media & Entertainment), as shown; not normalized. Often set only for business or creator accounts.
`external_links`	`object[]`	Links in the bio or channel links; [] if none or not exposed.
`external_links[].url`	`string` (uri)	Link target, absolute (https:// is added where the platform stores the link without a scheme).
`external_links[].title`	`string` or `null`	Link label shown by the platform.
`location`	`string` or `null`	Self-declared location text.
`country_code`	`string` or `null`	ISO 3166-1 alpha-2 country the platform states for the account.
`created_at`	`string` (date-time) or `null`	Account creation or join date, RFC 3339 UTC (some platforms give only the day: see approximate_fields).
`metrics`	`object`	Counts at fetch time; null = hidden or not exposed, 0 = zero.
`metrics.follower_count`	`integer` or `null`	Followers or subscribers.
`metrics.following_count`	`integer` or `null`	Accounts this profile follows.
`metrics.post_count`	`integer` or `null`	Posts or videos as the platform counts them on the profile (for a private account, posts the caller cannot see).
`metrics.total_like_count`	`integer` or `null`	Likes received across all of the profile's posts (not likes given).
`metrics.total_view_count`	`integer` or `null`	Lifetime views across all of the profile's posts.
`platform_specific`	`object`	Fields only this platform has, under its ID (platform_specific.<platform>); each null when unknown.
`platform_specific.youtube`	`object` or `null`	A YouTube channel's own fields (core/profile_youtube.go).
`platform_specific.youtube.keywords`	`string[]`	The channel's keywords as its owner wrote them, a quoted phrase as one keyword; [] when it has none (listed in unknown_fields when the source cannot see them).
`platform_specific.youtube.is_official_artist_channel`	`boolean` or `null`	True for an Official Artist Channel (the note badge after its name), false for any other channel; null when the page shows no badge row (YouTube's built-in channels).
`platform_specific.youtube.is_subscriber_count_hidden`	`boolean` or `null`	True when the channel hides its subscriber count (metrics.follower_count is then null; neither its About panel nor its header shows one), false when YouTube shows it; null when that cannot be told (no About panel or header seen).
`platform_specific.youtube.is_business_email_listed`	`boolean` or `null`	True when the channel lists a business email (shown to signed-in users only; the address is not returned); null otherwise, since YouTube shows nothing for a channel without one.
`platform_specific.instagram`	`object` or `null`	An Instagram account's own fields (core/profile_instagram.go).
`platform_specific.instagram.fbid`	`string` or `null`	The account's Meta-wide ID (17841…), the one Meta's Instagram Graph API uses; id is Instagram's own user ID. Null when the source does not show it.
`platform_specific.instagram.is_memorialized`	`boolean` or `null`	True when Instagram has memorialized the account (its owner has died), false otherwise; null when unknown.
`platform_specific.instagram.is_story_live`	`boolean` or `null`	True when the account has a story up now (stories last 24 hours), false when it has none; null when unknown (Instagram does not say for private accounts).
`platform_specific.instagram.is_highlights_shown`	`boolean` or `null`	True when the profile shows story highlights, false when it shows none; null when unknown (private accounts, or a source that does not show them).
`platform_specific.instagram.pronouns`	`string[]`	The pronouns the owner chose to show on the profile, as shown; [] when none (listed in unknown_fields when the source cannot see them).
`platform_specific.rumble`	`object` or `null`	A Rumble channel's or user's own fields (core/profile_rumble.go).
`platform_specific.rumble.account_type`	`string` or `null`	channel for a Rumble channel (rumble.com/c/<name>), user for a Rumble user (rumble.com/user/<name>: the account that uploads, which can own channels). Null when unknown. New values may be added; treat unknown values as unknown. One of `channel`, `user`
`platform_specific.rumble.numeric_id`	`string` or `null`	Rumble's numeric ID of the channel or the user, in decimal (the channel's is the number in its rumble.com/c/c-<id> link). Channels and users are numbered separately, so the same number can name a channel and a user: id is the unambiguous reference. Null when unknown.
`platform_specific.rumble.user_id`	`string` or `null`	The id of the Rumble user that owns the channel (_u…, the id this endpoint answers for that user); for a user, its own id. Channels of one owner share it. Null when the page does not show it.
`platform_specific.threads`	`object` or `null`	A Threads account's own fields (core/profile_threads.go).
`platform_specific.threads.interest_tags`	`string[]`	Topic labels Threads shows on the profile, as shown; [] when it shows none (listed in unknown_fields when the source cannot see them).
`platform_specific.threads.verified_link_urls`	`string[]`	The external_links URLs Threads marks as verified, in the same form; [] when none is marked (listed in unknown_fields when the source cannot see the links).
`approximate_fields`	`string[]`	JSON paths of values rounded by the platform or parsed from display text (e.g. metrics.follower_count). A list path (external_links) means the list may be incomplete. [] when all exact.
`unknown_fields`	`string[]`	JSON paths of lists whose [] means unknown rather than none (a source that cannot see them); null already means unknown for every other field. [] when every list is known.

platformstring

Platform ID (tiktok, youtube, …).

idstring

Platform-native account ID (string; YouTube UC…, Reddit without t2_).

usernamestringnullable

Handle without the @; null when the account has none.

display_namestringnullable

Display name, channel title or page name; null when empty or not exposed.

urlstring uri

Canonical profile URL.

typestring

Coarse account kind, as the platform labels it; unknown when it does not (TikTok labels organizations only). New values may be added; treat unknown values as unknown.

One ofpersonorganizationcommunityunknown

biostringnullable

Profile bio, channel description or page about text; null when empty or not exposed.

avatar_urlstring urinullable

Profile picture URL (largest available). Platform CDN URLs can expire within hours.

banner_urlstring urinullable

Header or cover image URL.

is_verifiedbooleannullable

Platform verification badge; null where the platform has no badge.

is_privatebooleannullable

True when the account's posts are not public.

categorystringnullable

Platform category label (e.g. Musician, Media & Entertainment), as shown; not normalized. Often set only for business or creator accounts.

external_linksobject[]

Links in the bio or channel links; [] if none or not exposed.

Show 2 child fields

urlstring uri

Link target, absolute (https:// is added where the platform stores the link without a scheme).

titlestringnullable

Link label shown by the platform.

locationstringnullable

Self-declared location text.

country_codestringnullable

ISO 3166-1 alpha-2 country the platform states for the account.

created_atstring date-timenullable

Account creation or join date, RFC 3339 UTC (some platforms give only the day: see approximate_fields).

metricsobject

Counts at fetch time; null = hidden or not exposed, 0 = zero.

Show 5 child fields

follower_countintegernullable

Followers or subscribers.

following_countintegernullable

Accounts this profile follows.

post_countintegernullable

Posts or videos as the platform counts them on the profile (for a private account, posts the caller cannot see).

total_like_countintegernullable

Likes received across all of the profile's posts (not likes given).

total_view_countintegernullable

Lifetime views across all of the profile's posts.

platform_specificobject

Fields only this platform has, under its ID (platform_specific.<platform>); each null when unknown.

Show 4 child fields

youtubeobjectnullable

A YouTube channel's own fields (core/profile_youtube.go).

Show 4 child fields

keywordsstring[]

The channel's keywords as its owner wrote them, a quoted phrase as one keyword; [] when it has none (listed in unknown_fields when the source cannot see them).

is_official_artist_channelbooleannullable

True for an Official Artist Channel (the note badge after its name), false for any other channel; null when the page shows no badge row (YouTube's built-in channels).

is_subscriber_count_hiddenbooleannullable

True when the channel hides its subscriber count (metrics.follower_count is then null; neither its About panel nor its header shows one), false when YouTube shows it; null when that cannot be told (no About panel or header seen).

is_business_email_listedbooleannullable

True when the channel lists a business email (shown to signed-in users only; the address is not returned); null otherwise, since YouTube shows nothing for a channel without one.

instagramobjectnullable

An Instagram account's own fields (core/profile_instagram.go).

Show 5 child fields

fbidstringnullable

The account's Meta-wide ID (17841…), the one Meta's Instagram Graph API uses; id is Instagram's own user ID. Null when the source does not show it.

is_memorializedbooleannullable

True when Instagram has memorialized the account (its owner has died), false otherwise; null when unknown.

is_story_livebooleannullable

True when the account has a story up now (stories last 24 hours), false when it has none; null when unknown (Instagram does not say for private accounts).

is_highlights_shownbooleannullable

True when the profile shows story highlights, false when it shows none; null when unknown (private accounts, or a source that does not show them).

pronounsstring[]

The pronouns the owner chose to show on the profile, as shown; [] when none (listed in unknown_fields when the source cannot see them).

rumbleobjectnullable

A Rumble channel's or user's own fields (core/profile_rumble.go).

Show 3 child fields

account_typestringnullable

channel for a Rumble channel (rumble.com/c/<name>), user for a Rumble user (rumble.com/user/<name>: the account that uploads, which can own channels). Null when unknown. New values may be added; treat unknown values as unknown.

One ofchanneluser

numeric_idstringnullable

Rumble's numeric ID of the channel or the user, in decimal (the channel's is the number in its rumble.com/c/c-<id> link). Channels and users are numbered separately, so the same number can name a channel and a user: id is the unambiguous reference. Null when unknown.

user_idstringnullable

The id of the Rumble user that owns the channel (_u…, the id this endpoint answers for that user); for a user, its own id. Channels of one owner share it. Null when the page does not show it.

threadsobjectnullable

A Threads account's own fields (core/profile_threads.go).

Show 2 child fields

interest_tagsstring[]

Topic labels Threads shows on the profile, as shown; [] when it shows none (listed in unknown_fields when the source cannot see them).

verified_link_urlsstring[]

The external_links URLs Threads marks as verified, in the same form; [] when none is marked (listed in unknown_fields when the source cannot see the links).

approximate_fieldsstring[]

JSON paths of values rounded by the platform or parsed from display text (e.g. metrics.follower_count). A list path (external_links) means the list may be incomplete. [] when all exact.

unknown_fieldsstring[]

JSON paths of lists whose [] means unknown rather than none (a source that cannot see them); null already means unknown for every other field. [] when every list is known.

Item errors

Besides the request-level errors every endpoint can return, profile endpoints return:

Code	HTTP	Retry	Meaning	What to do
`not_found`	404	No	The item does not exist or was deleted.	Check the URL or ID; do not retry.
`private_or_unavailable`	403	No	The item exists but is private, age- or region-gated, or requires a login to view. It shares 403 with forbidden (which is about the key): branch on the code.	Only public items can be fetched; do not retry.

not_found, private_or_unavailable (see error codes).