Skip to content
Gridlode
Docs · Reference

TikTok Profile

GET /v1/social/tiktok/profile2 credits / requestcache 360 min

A public TikTok creator or brand profile exactly as a signed-out visitor sees it: nickname, handle, verified badge, bio and bio link, exact follower, following, like and video counts, avatar and join date, plus the latest videos (id, caption, date, plays, cover, link) from TikTok's public creator embed. Private and banned accounts are never returned. E-mail addresses and phone numbers inside bios and captions are masked. Unknown accounts, blocks and failures are free.

Query parameters

username
string · required
TikTok handle with or without @ (e.g. 'tiktok'), or a profile URL such as https://www.tiktok.com/@tiktok.
limit
integer
How many of the latest videos to include (0-10). 0 returns the profile only.
Default: 10
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/social/tiktok/profile?username=tiktok&limit=5" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the TikTok Profile API page.