Introduction

Embedded Videos enable TikTok videos to be embedded into your articles or websites. This helps to foster storytelling, and provides proper attribution by showing the video creator, video description and background sound in the form of TikTok's custom player; it also links back to the corresponding content on tiktok.com

Embed from TikTok.com

You can get the embed code by visiting the video webpage on tiktok.com—it's located near the lower right-side share corner of the video display card. Click the "Get Embed Code" button, as pictured in the following photo.

Example video webpage for embedding

Once you have clicked on this button, a popup window with the HTML code will prompt. Simply copy and paste the code into the destination webpage, where you wish to attach the video, and voilà, the embedded video will automatically load on the page.

Embedded videos come with fixed length-to-width ratio as vertical cards. The vertical card supports volume control during playback, and users will be recommended additional videos at the end of each playback.

-Volume ControlFull Screen PlaybackVideo Recommendation
Mobileyesnoyes
Web(desktop)yesyesyes

On top of each video, there are overlay texts and buttons, as seen above. These elements are interactive, and by tapping on them, the user will be linked directly to the corresponding content page on tiktok.com. The "Watch more on TikTok" button at the bottom of the embedded card will either link users to the Trending Page if the user is browsing on the web (desktop), or deeplink users to the TikTok product page on the App Store / Google Play if browsing on mobile.

Example of embedded video

A video's availability is consistent in and outside the TikTok app, as moderation standards and results are applied to both in-app content 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.

Embedded for developers

convert a TikTok's video URL into embedded video markup by using the oEmbed API. It allows you to get the embed code and additional information about the video associated with the webpage link provided.

API

GET/oembedReturns the embed code and infomation about the video

Parameters

Request

RequestDescription
urlThe video 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/video/6718335390845095173

Response Data

{
  "author_url": "https://www.tiktok.com/@scout2015",
  "title": "Scramble up ur name & I’ll try to guess it😍❤️ #foryoupage #petsoftiktok #aesthetic",
  "author_name": "Scout & Suki",
  "width": 340,
  "height": 700,
  "html": "<iframe width=\"340\" height=\"700\" src=\"https://www.tiktok.com/embed/6718335390845095173\" frameborder=\"0\" allow=\"accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture\" allowfullscreen></iframe>",
  "thumbnail_width": 720,
  "thumbnail_height": 1280,
  "thumbnail_url": "https://m-p16.akamaized.net/obj/tos-maliva-p-0068/06kv6rfcesljdjr45ukb0000d844090v0200000a05",
  "provider_url": "https://www.tiktok.com/",
  "provider_name": "TikTok",
  "version": "1.0",
  "type": "video"
}