Skip to main content
GET
/
v1
/
tiktok
/
oembed
Get oEmbed Metadata
curl --request GET \
  --url https://scrapebadger.com/v1/tiktok/oembed \
  --header 'x-api-key: <api-key>'
{
  "version": "1.0",
  "type": "video",
  "title": "new dance #fyp #dance",
  "author_name": "charli d'amelio",
  "author_url": "https://www.tiktok.com/@charlidamelio",
  "provider_name": "TikTok",
  "provider_url": "https://www.tiktok.com",
  "html": "<blockquote class=\"tiktok-embed\" ...></blockquote>",
  "thumbnail_url": "https://p16-sign.tiktokcdn-us.com/oembed.jpeg",
  "thumbnail_width": 576,
  "thumbnail_height": 1024,
  "embed_product_id": "7234567890123456789",
  "embed_type": "video"
}
Each request costs 2 credits. Failed requests are not charged.

Authorizations

x-api-key
string
header
required

Query Parameters

url
string
required

Full TikTok video or profile URL.

region
string
default:US

Content region (ISO 3166-1 alpha-2). Routes the request through a proxy and signer for that locale.

Response

200 - application/json

oEmbed metadata

oEmbed metadata for a TikTok URL.

version
string
type
string
title
string
author_name
string
author_url
string
provider_name
string
provider_url
string
html
string

Embed HTML snippet.

thumbnail_url
string
thumbnail_width
integer
thumbnail_height
integer
embed_product_id
string
embed_type
string