TikTok for Developers

Docs

Introduction

Creator Profile Embed allows TikTok creator profiles to be embedded into your articles or websites. With this tool you can showcase an overview of a creator's presence on TikTok, including the number of users who follow that creator, the number of users that creator follows, and the number of likes that creator has received across all of their TikTok videos. The embedded creator profile also contains a selection of up to ten of the creator's most recent videos. Like embedded videos, most of the components in an embedded creator profile link back to the corresponding pages on TikTok.com or the app.

Private and underage accounts

Private accounts and underage accounts cannot be embedded. In these cases, the share icon will be grayed out and won't be interactive. Accounts which are later set as "private" on TikTok will be shown as private on the embed profile card as well, as are underage accounts. Users who have not yet set their age in their TikTok profile are shown as private by default.

Embed from TikTok.com

You can get the embed code by visiting the creator's profile page on TikTok.com. Click the share icon and select "Embed" from the dropdown.

See https://www.tiktok.com/@scout2015 to see this embed workflow

Once you have clicked on this button, a popup card will appear with the embed code. Click "Copy code" to copy the entire embed code to your clipboard and paste it where you wish to display the creator profile card. The embedded profile card will automatically show up on your page.


Creator Profile Embed can support a wide variety of screens. Videos will automatically play when moused over on desktop or when on-screen on mobile and can be scrolled to the side.


-

Autoplay

Scroll

Mobile

Whenever on-screen

Yes - tap and scroll

Desktop

On mouseover

Yes - mouse scroll, scrollbar

Desktop

Mobile





Most of the components on the embedded creator profile are interactive. By clicking or tapping on them, the user will be linked directly to the corresponding content page on TikTok.com or the app. The "Open TikTok" button at the bottom of the embedded profile card will link users to the creator’s profile page, as will the avatar, username, metrics, and user description. Video cards contained within the embedded creator profile link to their respective videos in the webpage or the app.

The same moderation standards apply to both in-app and embedded content. For example, if a video has been removed from the TikTok app, the same video in its embedded form on the web will no longer be accessible.

Note: Some browsers in China will forbid the use of TikTok's custom player and show the default player provided by the browser.

Embed for developers

Programmatically, you may convert a TikTok creator profile URL into embedded markup by using the oEmbed API. It allows you to get the embed code and additional information about the creator profile associated with the webpage link provided.

API

GET

/oembed

Returns the embed code and information about the creator profile

Parameters

Request

Param

Description

url

The creator profile link for embedding

Response

The response format follows the specification of https://oembed.com/, please check it out for more details.

Example

Request URL

https://www.tiktok.com/oembed?url=https://www.tiktok.com/@scout2015

Response Data

{
  "version":"1.0",
  "type":"rich",
  "title":"Scout, Suki & Stella's Creator Profile",
  "author_url":"https://www.tiktok.com/@scout2015",
  "author_name":"Scout, Suki & Stella",
  "width":"100%",
  "height":"100%",
  "html":"<blockquote class=\"tiktok-embed\" cite=\"https://www.tiktok.com/@scout2015\" data-unique-id=\"scout2015\"  data-embed-type=\"creator\" style=\"max-width: 720px; min-width: 288px;\" data-embed-from=\"oembed\"> <section> <a target=\"_blank\" href=\"https://www.tiktok.com/@scout2015?refer=creator_embed\">@scout2015</a> </section> </blockquote> <script async src=\"https://www.tiktok.com/embed.js\"></script>",
  "provider_url":"https://www.tiktok.com",
  "provider_name":"TikTok"
}