Skip to content
ScrapeField
Get a key

Get one TikTok video

Fetch one TikTok video by URL or id: video_description, username, create_time, duration, the counts, the sound and whether duets and stitches are allowed.

3 credits
GEThttps://api.scrapefield.com/v1/tiktok/video
Try itno key needed3 credits on a real call · 0 here
https://api.scrapefield.com/v1/tiktok/video?id=7412345678901234567

In your code

const params = new URLSearchParams({
  "id": "7301234567890123456"
});

const res = await fetch(`https://api.scrapefield.com/v1/tiktok/video?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPEFIELD_KEY}` },
});

const { data, meta } = await res.json();
console.log(data, meta.credits_charged);

Parameters

Parameters
ParameterWhat it does
url
string · one of the video ids
The video URL, https://www.tiktok.com/@…/video/…. A short vm.tiktok.com link is not read: open it, and copy the address it leads to.
id
string · one of the video ids
The numeric video id.
fresh
boolean
Skip the cache and fetch now. Charged normally. Not available on trial credits — buy any pack to unlock it.
default false

Response

Returns one tiktok_video. This is the demo’s answer, the one the playground above returns, in full rather than abbreviated — including the fields that come back null, because a field is null when the platform does not show it and you should know which ones those are before you build on them. A call with your key returns the account you ask for.

{
  "data": {
    "id": "7412345678901234567",
    "share_url": "https://www.tiktok.com/@blue.door.coffee/video/7412345678901234567",
    "username": "blue.door.coffee",
    "video_description": "Same corner, four years apart. #roastery #citywalk #fyp",
    "create_time": "2026-07-22T10:38:13.000Z",
    "duration": 26,
    "cover_image_url": "https://cdn.example/tt/7412345678901234567.jpeg",
    "play_url": "https://cdn.example/tt/7412345678901234567.mp4",
    "view_count": 3801250,
    "like_count": 309238,
    "comment_count": 11779,
    "share_count": 6484,
    "favorites_count": 18303,
    "hashtag_names": [
      "roastery",
      "citywalk",
      "fyp"
    ],
    "region_code": "US",
    "music": {
      "id": "7267972559455164041",
      "title": "original sound - blue.door.coffee",
      "author": "blue.door.coffee",
      "original": true
    },
    "duet_enabled": true,
    "stitch_enabled": false
  },
  "meta": {
    "request_id": "req_7f3ac1e94b2d40f8a1c6e5d2",
    "credits_charged": 3,
    "credits_remaining": 74218,
    "cached": false,
    "fetched_at": "2026-09-20T09:12:03Z",
    "next_cursor": null
  }
}

Fields of tiktok_video

A TikTok video. Named after TikTok's Display and Research APIs.

Fields
FieldWhat it is
id
string
TikTok's numeric id — the number at the end of the URL.
share_url
URL
The video.
username
string
Who posted it.
video_description
string · or null
The caption.
create_time
time, ISO 8601 UTC · or null
When it was posted. null when the source does not say.
duration
integer · or null
Seconds. null when the source does not give it.
cover_image_url
URL · or null
The video's cover image. On TikTok's CDN. TikTok signs the link, and it can stop working within hours, so fetch the file soon. We do not rehost media.
play_url
URL · or null
The video file. On TikTok's CDN. TikTok signs the link, and it can stop working within hours, so fetch the file soon. We do not rehost media.
view_count
integer · or null
null when the source does not give it.
like_count
integer · or null
null when the source does not give it.
comment_count
integer · or null
null when the source does not give it.
share_count
integer · or null
null when the source does not give it.
favorites_count
integer · or null
Saves. null where the page does not show them.
hashtag_names
array of strings
Without the #.
region_code
string · or null
Where it was posted from, ISO 3166-1 alpha-2.
music
object · or null
The sound.
music.id
string
TikTok's id for the sound.
music.title
string
The sound's name, as TikTok shows it.
music.author
string · or null
Who the sound is credited to.
music.original
boolean
An original sound rather than a track.
duet_enabled
boolean · or null
null where that is not known.
stitch_enabled
boolean · or null
null where that is not known.

What it costs

3 credits per successful call, whether we fetch it or serve it from cache — you pay for the answer, not for how we produced it. Responses are cached for 3 hours and a cached one tells you when the data was actually fetched. A call we fail costs 0 and is refunded automatically.

On the smallest pack that is $2.34 per 1,000 calls; on the largest, $1.32. The full table.

Questions

How much does the TikTok video details API cost?

3 credits a call: $2.34 per 1,000 calls on the smallest pack and $1.32 on the largest. A call that fails costs nothing, and the refund is automatic. A cached answer costs the same as a fresh one. Credits are bought in packs and never expire; there is no plan.

Do I need a TikTok account, a login or cookies?

No. You need a key from us and nothing from TikTok. We never take a customer's login, cookies or session, at any price, and no account of yours is ever at risk.

Can I try it without signing up?

Yes. Add demo=true and leave the key out, or press Send request in the playground on this page. The demo answers with a real answer about Ferrari, captured once a week, in exactly the shape a live call returns, whatever you ask, and charges nothing.

How fresh is the data?

An answer is kept for up to 3 hours, and a cached one says when it was fetched, in meta.fetched_at. Add fresh=true to fetch it again now, at the same price; it needs any purchase, not the trial.

What does it return?

One tiktok_video object. Its fields are named after TikTok's Display and Research APIs. A field is null when TikTok does not show it, never missing. Every field is described on this page.

Can an AI agent call it?

Yes: it is the MCP tool get_tiktok_video on our MCP server, with the same parameters, answer and price. Without a key, the tool answers from the demo.