ScrapeField
Get a key

Get one 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.

2credits
GEThttps://api.scrapefield.com/v1/tiktok/video
Try itno key needed2 credits on a real call · 0 here
https://api.scrapefield.com/v1/tiktok/video

In your code

curl -H "Authorization: Bearer $SCRAPEFIELD_KEY" \
  "https://api.scrapefield.com/v1/tiktok/video?url=example"

Parameters

ParameterWhat it does
url
string · one of the video ids
The video URL.
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 a real response, not an abbreviated one — 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.

{
  "data": {
    "id": "7435301074483764206",
    "share_url": "https://www.tiktok.com/@example/video/7435301074483764206",
    "username": "example",
    "video_description": "Three days of proofing and it finally behaved. #baking #citywalk #fyp",
    "create_time": "2026-08-25T21:15:26.000Z",
    "duration": 151,
    "cover_image_url": "https://cdn.example/tt/7435301074483764206.jpeg",
    "play_url": "https://cdn.example/tt/7435301074483764206.mp4",
    "view_count": 273195,
    "like_count": 19541,
    "comment_count": 914,
    "share_count": 488,
    "favorites_count": 307,
    "hashtag_names": [
      "baking",
      "citywalk",
      "fyp"
    ],
    "region_code": "US",
    "music": {
      "id": "6959048832134002744",
      "title": "Gymnopédie No. 1",
      "author": "Erik Satie",
      "original": false
    },
    "duet_enabled": true,
    "stitch_enabled": false
  },
  "meta": {
    "request_id": "req_7f3ac1e94b2d40f8a1c6e5d2",
    "credits_charged": 2,
    "credits_remaining": 74218,
    "cached": false,
    "fetched_at": "2026-09-20T09:12:03Z",
    "next_cursor": null
  }
}

Fields of tiktok_video

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

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
When it was posted.
duration
integer
Seconds.
cover_image_url
URL · or null
play_url
URL · or null
The video file on TikTok's CDN. TikTok signs it and it stops working after a while, so fetch it soon. We do not rehost videos.
view_count
integer
like_count
integer
comment_count
integer
share_count
integer
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
music.title
string
music.author
string · or null
music.original
boolean
An original sound rather than a track.
duet_enabled
boolean
stitch_enabled
boolean

What it costs

2 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 $1.56 per 1,000 calls; on the largest, $0.80. The full table.