TikTok oEmbed Lookup

PythonSocial Media

POST api.upapi.io/tiktok-oembed.get

Resolve any TikTok profile or video URL to its title, author and thumbnail via TikTok's public oEmbed endpoint. No auth, no signing.

tiktokoembedmetadatasocialscraping

AuthAPI key

Cost1 unit

Timeout20s

Cache3600s

Request schema

Field	Type	Description
`url`req	string	Any TikTok profile or video URL, e.g. https://www.tiktok.com/@tiktok
`proxyUrl`		Optional proxy URL. "none" forces a direct request; omit to auto-pick.· default: `null`

Response schema

Field	Type	Description
`title`req	string
`success`req	boolean
`urlType`req	string	"video" for a video URL, otherwise "profile"
`authorUrl`req	string
`elapsedMs`req	integer
`fetchedAt`req	string
`authorName`req	string
`providerName`req	string
`thumbnailUrl`		· default: `null`
`embedProductId`req	string
`thumbnailWidth`		· default: `null`
`thumbnailHeight`		· default: `null`

Try it

urlrequired

Any TikTok profile or video URL, e.g. https://www.tiktok.com/@tiktok

proxyUrloptional· default: null

Optional proxy URL. "none" forces a direct request; omit to auto-pick.

Run this endpoint live

Jump in as a guest — no signup — and run tiktok-oembed.get with your own inputs. Create a free account anytime to get your own API key.

Code examples

curl -X POST https://api.upapi.io/tiktok-oembed.get \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "url": "https://www.tiktok.com/@tiktok" }'

Developer tools

OpenAPI specImport the spec or collection into Postman, Insomnia, or any codegen tool.