Docs · Video details

Video details

One video or photo post: caption, stats, author, sound, hashtags and a playable MP4 URL.

1 credit per callFresh within 15 minutesMCP tool: tiktok_video

GEThttps://api.lurkapi.com/v2/tiktok/video

When to use this

Use it to track a post's views, likes, comments, shares and saves, or to get its media. video.playUrl plays without cookies until video.expires_at (about two days); fetch the post again for a fresh one. Photo posts have their slides in images.

Pass get_transcript=true to also get the captions as WEBVTT in transcript (same credit).

Deleted, private and region-locked posts return 404 not_found.

Parameters

All parameters go in the query string.

Parameter	Description
`url` stringrequired	The video's URL, e.g. `https://www.tiktok.com/@hubspot/video/7671325437229845774`. Photo post URLs and bare video ids work too. Example `https://www.tiktok.com/@hubspot/video/7671325437229845774`
`get_transcript` booleanoptional	`true` adds the captions as WEBVTT in `transcript` (null if the video has none). One of `truefalse` Default `false`

Example request

Replace YOUR_API_KEY with your key, or set LURKAPI_KEY for the code. Get a free key.

curlJavaScriptPython

JavaScript · reads your key from LURKAPI_KEY

const params = new URLSearchParams({
  url: "https://www.tiktok.com/@hubspot/video/7671325437229845774",
});
const res = await fetch(`https://api.lurkapi.com/v2/tiktok/video?${params}`, {
  headers: { "x-api-key": process.env.LURKAPI_KEY },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.code}: ${data.error}`);
console.log(data.hashtags);

Python · reads your key from LURKAPI_KEY

import os
import requests

res = requests.get(
    "https://api.lurkapi.com/v2/tiktok/video",
    params={
        "url": "https://www.tiktok.com/@hubspot/video/7671325437229845774",
    },
    headers={"x-api-key": os.environ["LURKAPI_KEY"]},
    timeout=60,
)
data = res.json()
if not data["success"]:
    raise RuntimeError(f"{data['code']}: {data['error']}")
print(data["hashtags"])

Example response

A real response from this endpoint, captured from the live API and trimmed to a couple of items. Strings over 96 characters (mostly signed media URLs) are cut short and end in ….

Show the example response (2 KB)

{
  "success": true,
  "credits_remaining": 99984,
  "credits_charged": 1,
  "id": "7671325437229845774",
  "url": "https://www.tiktok.com/@hubspot/video/7671325437229845774",
  "desc": "love at first MQL",
  "createTime": 1786119661,
  "textLanguage": "en",
  "locationCreated": "US",
  "isAd": true,
  "author": {
    "id": "6921028957732193285",
    "uniqueId": "hubspot",
    "nickname": "HubSpot",
    "secUid": "MS4wLjABAAAAuY18L_r3HfP3KEtK0txT2RPxDj1uSMSqbHZF33aYcGVAwL3PUA50WeQkR2o53xqr",
    "verified": true,
    "privateAccount": false,
    "avatarThumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7351755…",
    "avatarLarger": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7351755…"
  },
  "stats": {
    "playCount": 1104,
    "diggCount": 25,
    "commentCount": 1,
    "shareCount": 0,
    "collectCount": 2,
    "repostCount": 0
  },
  "video": {
    "duration": 80,
    "width": 720,
    "height": 1280,
    "definition": "720p",
    "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-85c255-tx/okN7mcf…",
    "dynamicCover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-85c255-tx/oEDEMCV…",
    "playUrl": "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=30509d3782234485…",
    "expires_at": 1790947227
  },
  "music": {
    "id": "7671325566393486094",
    "title": "original sound - HubSpot",
    "authorName": "HubSpot",
    "original": true,
    "duration": 80,
    "playUrl": "https://v16m.tiktokcdn-us.com/1eb8f6572957ab7073bf9056849b1a2c/6abd60fb/…",
    "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7351755…"
  },
  "hashtags": [],
  "mentions": [],
  "images": []
}

Response fields

Every field of a successful response. [] marks a list: a[].b is the b of each item in a. nullable fields can be null; optional fields can be missing.

Show all 50 fields

Field	Type	Description
success	true	Always true here; errors have `success: false`.
credits_remaining	number	Your balance after this call. On anonymous playground calls: free tries left today.
credits_charged	number	Credits this call cost; 0 on free endpoints. On anonymous playground calls: tries used (1).
id	string	Video id, e.g. `7671325437229845774`.
url	string	The post on tiktok.com.
desc	string	Caption, hashtags included.
createTime	number	Posted at, Unix seconds.
textLanguage	stringnullable	Caption language as TikTok detects it, e.g. `en`; null if unknown.
locationCreated	stringnullable	Country the post was made in, as a 2-letter code; null if unknown.
isAd	boolean	A paid ad (Spark Ad or promoted post).
author	object	Who posted it.
author.id	string	Numeric user id.
author.uniqueId	string	Username (handle), without @.
author.nickname	string	Display name.
author.secUid	string	TikTok's long, stable user id; other tools ask for it.
author.verified	boolean	Has the verified badge.
author.privateAccount	boolean	The account is private.
author.avatarThumb	stringnullable	Small avatar URL (expires after a few days); null if TikTok has none.
author.avatarLarger	stringnullable	Large avatar URL (expires after a few days); null if TikTok has none.
stats	object	Engagement when fetched. Exact numbers, not rounded.
stats.playCount	number	Views.
stats.diggCount	number	Likes.
stats.commentCount	number	Comments.
stats.shareCount	number	Shares.
stats.collectCount	numbernullable	Saves (favorites); null where TikTok doesn't show it.
stats.repostCount	numbernullable	Reposts; null where TikTok doesn't show it.
video	object	The video file. For photo posts see `images`.
video.duration	number	Length in seconds; 0 for photo posts.
video.width	number	Width in pixels; 0 for photo posts.
video.height	number	Height in pixels; 0 for photo posts.
video.definition	stringnullable	Quality of the default rendition, e.g. `720p`.
video.cover	stringnullable	Cover image URL (expires after a few days); null if TikTok has none.
video.dynamicCover	stringnullable	Animated cover URL (expires after a few days); null if TikTok has none.
video.playUrl	stringnullable	MP4 URL that plays without cookies (h264, best quality). It redirects to TikTok's CDN and expires at `expires_at`; null if TikTok has none.
video.expires_at	numbernullable	When `playUrl` stops working, Unix seconds; null if unknown.
music	objectnullable	The sound; null if the post has none.
music.id	string	Sound id; pass it to song endpoints.
music.title	string	Sound title, e.g. `original sound`.
music.authorName	stringnullable	Artist, or the creator for original sounds.
music.original	boolean	An original sound made with this post rather than a track.
music.duration	numbernullable	Length in seconds.
music.playUrl	stringnullable	Audio URL (expires after a few hours); null if TikTok has none.
music.cover	stringnullable	Sound cover image URL; null if TikTok has none.
hashtags	string[]	Hashtags in the caption, without #.
mentions	string[]	Usernames @mentioned in the caption.
images	object[]	The slides of a photo post, in order. Empty for videos.
images[].url	string	Image URL (expires after a few days).
images[].width	number	Width in pixels.
images[].height	number	Height in pixels.
transcript	stringnullable · optional	With `get_transcript=true`: the captions as WEBVTT in the video's original language; null if it has none.

Caching and freshness

Responses are cached for up to 15 minutes, so a repeat call within that window can return the same data. It still costs 1 credit.

Errors

Errors return { success: false, error, code, docs } with the HTTP status below. Validation errors, 401/402/429 rejections and 5xx failures are free; not_found is charged (how charging works). All error codes.

Status	Code	Meaning
401	`missing_api_key`	No API key. Send it in the `x-api-key` header.
401	`invalid_api_key`	The key is unknown or was revoked.
402	`insufficient_credits`	Not enough credits for this call. Buy a pack or wait for tomorrow's top-up.
404	`not_found`	The endpoint, or the thing you asked for (ad, post, subreddit), doesn't exist. Charged when the platform was checked.
405	`method_not_allowed`	Endpoints take GET with query params.
429	`rate_limited`	Too many calls at once. Wait for the `retry-after` seconds, then retry.
500	`internal_error`	Something broke on our side. Retry; 5xx errors are free.
502	`upstream_error`	The platform didn't give a usable answer. Retry; 5xx errors are free.
503	`upstream_busy`	All our connections to the platform are busy. Retry in a few seconds; 5xx errors are free.
504	`upstream_timeout`	The platform took over 30 seconds to answer. Retry; timeouts are free.

Use it in Claude

Once LurkAPI is connected to Claude, this endpoint is the tiktok_video tool. Ask in plain English, for example:

Ask Claude

Use LurkAPI's tiktok_video with url "https://www.tiktok.com/@hubspot/video/7671325437229845774" and summarize what you find.

Claude calls tiktok_video with arguments like these, and each call costs 1 credit:

Tool arguments

{
  "url": "https://www.tiktok.com/@hubspot/video/7671325437229845774"
}

Tool results skip nulls and empty lists to save tokens.