TikTok video scraper API

Social & communities · v1.1.0 · tiktok_video

$0.004 / video

$4.00 / 1K · pay per delivered video

A TikTok video scraper API that returns per-video metrics for a list of URLs or ids: views, likes, comments, shares and saves, plus caption, publish time, author and author follower count, duration, music and hashtags.

By Aldo Morese, founder of QuanticData · Published Aug 21, 2026 · Updated Sep 3, 2026

Run in dashboard See the request

$0.004 per delivered video · $2 free every month · Failed runs never billed

What it does

What a TikTok video scraper API does

Campaign reporting lives at the video level. This collector takes the URLs you already have — from a brief, a creator report or a hashtag list — and returns the five engagement counts TikTok publishes, exact, with the author's follower count on the same row so engagement rate is one division away.

Worth knowing how failure looks here: TikTok answers a removed, private or region-locked video with HTTP 200 and an error code buried in the page data. The collector reads that status, so those ids land under failed with TikTok's own reason instead of being billed as delivered rows.

Inputs

The whole request. Anything you leave out falls back to the default shown in the catalog.

Input	Type	Required	What it does
`videos`	array	yes	Video URLs (https://www.tiktok.com/@user/video/123…) or numeric ids.
`country`	string	no	ISO 3166-1 alpha-2 code — proxy exit geo and Google locale (gl). Omit for the default pool.
`max_results`	integer	no	How many videos to deliver at most (1–50). You pay only for delivered videos.

Outputs — 39 fields, one row per video

What one video looks like

Every delivered video carries these fields. Nullable means the source did not publish it — the field stays empty instead of being guessed.

Field	Type	What it holds
`rank`	integer	1-based delivery order.
`video_id`	string	TikTok video id.
`url`	string	Video URL.
`description`	string · nullable	Caption.
`created_at`	string · nullable	Publish time (ISO 8601).
`author`	string · nullable	Author handle.
`author_name`	string · nullable	Author display name.
`author_id`	string · nullable	Author id.
`author_verified`	boolean	Author verified badge.
`author_followers`	integer · nullable	Author follower count.
`views`	integer · nullable	Play count.
`likes`	integer · nullable	Like count.
`comments`	integer · nullable	Comment count.
`shares`	integer · nullable	Share count.
`saves`	integer · nullable	Save/collect count.
`duration_seconds`	integer · nullable	Duration in seconds.
`music`	string · nullable	Music title.
`music_author`	string · nullable	Music author.
`hashtags`	string[]	Hashtags in the caption.
`cover`	string · nullable	Cover image URL.
`mentions`	string[]	Accounts mentioned in the caption.
`reposts`	integer · nullable	Repost count.
`author_following`	integer · nullable	Accounts the author follows.
`author_likes`	integer · nullable	Total likes on the author's videos.
`author_videos`	integer · nullable	Videos published by the author.
`author_signature`	string · nullable	Author bio.
`music_id`	string · nullable	TikTok sound id.
`music_original`	boolean · nullable	True when the sound is the author's original.
`location_created`	string · nullable	Country the video was posted from.
`language`	string · nullable	Caption language.
`width`	integer · nullable	Video width (px).
`height`	integer · nullable	Video height (px).
`is_ad`	boolean	Marked as an ad.
`ai_generated`	boolean	Labelled AI-generated by TikTok.
`duet_enabled`	boolean · nullable	Duets allowed.
`stitch_enabled`	boolean · nullable	Stitches allowed.
`is_photo_post`	boolean	Photo carousel rather than a video.
`subtitle_languages`	string[]	Subtitle languages available.
`related_searches`	string[]	Searches TikTok suggests next to the video.

Integration

One POST, typed rows

Base URL https://api.quanticdata.io/v1, Bearer auth, the same key as every other Data API. Endpoint: POST /v1/scraper/collectors/tiktok_video/run.

curl -X POST https://api.quanticdata.io/v1/scraper/collectors/tiktok_video/run \
  -H "Authorization: Bearer $QD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"videos":["https://www.tiktok.com/@nasa/video/7668779420412284191"],"max_results":5}'

import requests

r = requests.post(
    "https://api.quanticdata.io/v1/scraper/collectors/tiktok_video/run",
    headers={"Authorization": f"Bearer {QD_API_KEY}"},
    json={
        "videos": [
            "https://www.tiktok.com/@nasa/video/7668779420412284191"
        ],
        "max_results": 5
    },
    timeout=120,
)
for row in r.json()["payload"]["results"]:
    print(row)

const res = await fetch(
  "https://api.quanticdata.io/v1/scraper/collectors/tiktok_video/run",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.QD_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"videos":["https://www.tiktok.com/@nasa/video/7668779420412284191"],"max_results":5}),
  },
);
const { payload } = await res.json();
console.table(payload.results);

claude mcp add quanticdata \
  -e QUANTICDATA_API_KEY=qd_live_your_key_here \
  -- npx -y quanticdata-mcp

# then, in the chat:
> run the tiktok_video collector with videos=["https://www.tiktok.com/@nasa/video/7668779420412284191"] and max_results=5

Example response

POST /v1/scraper/collectors/tiktok_video/run

$ curl $QD/tiktok_video/run \
    -H "Authorization: Bearer $QD_API_KEY" \
    -d '{"videos": ["https: //www.tiktok.com/@nasa/video/7668779420412284191"], "max_results": 5}'
{ "status": "done", "count": 5,
  "results": [
    {
      "video_id": "…",
      "url": "…",
      "description": "…",
      "created_at": "…" } ],
  "cost": 0.02 }
# 5 videos × $0.004 · nothing delivered, nothing charged

Try it

TikTok video, running now

Change the input and run it against the live collector — nothing to install, no sign-up.

Run it from your own code, on your own inputs

Same collector, same rows — $2 of free API credit every month, no card.

Get my free API key

TikTok video scraper API: from videos, QuanticData reads the TikTok video page and returns one row per video with author_name, description and created_at, at $0.004 per delivered video. — You send videos and country; the run goes out through a residential exit and comes back as videos with rank, video_id and description — 39 fields on every row — and you are billed $0.004 for each video actually delivered, nothing for a run that delivers none.

$0.004 / video500 videos on the free $2 every month

Semantic inputvideos, country, max_results — no URL lists

Up to 50videos per run, pagination handled for you

No browserread over HTTP/TLS — cheaper and faster than rendering

Pricing

TikTok video scraper API pricing

$0.004 per delivered video. A run that delivers nothing costs nothing: blocked pages, challenges and retries are on us, and the $2 monthly allowance covers about 500 videos before you spend anything.

$0.004per delivered video$4 per 1,000 delivered videos

500 videoson the free allowance$2 every month, no card

Zero rowszero chargeblocks, captchas and retries are on us

−30%on volume tiersthe catalog returns your key's price

Pay as you go

$0/mo

$2 free credit / month
60 requests / min
List unit prices

Starter

$19/mo

$15 free credit / month
300 requests / min
10% off unit prices

Growth

$79/mo

$50 free credit / month
600 requests / min
20% off unit prices

Scale

$299/mo

$250 free credit / month
1,200 requests / min
30% off unit prices

Same wallet, same key and same $2 monthly allowance as every other Data API. Prices are launch pricing read live from the billing config — GET /v1/scraper/collectors returns the price your key actually pays.

What people build with the TikTok video scraper API

Three shapes of work this endpoint was designed around.

Campaign reporting

Measure delivered views and engagement per posted video, with author reach attached.

Creative benchmarking

Compare hooks, duration and music against engagement across a set of videos.

Contract verification

Check that the videos an influencer invoiced for exist and performed as claimed.

TikTok video scraper API versus rolling your own

The differences that actually cost time when you build this in-house.

	DIY scraper	This collector
Removed videos	HTTP 200, parsed as empty, billed	Status read, reported under failed, not billed
Engagement rate	Two separate calls	Author followers on the same row

What people search for

Live autocomplete demand around TikTok video, pulled with our own Keyword ideas collector.

Metrics for videos nobody authorised you to read

The Display API covers videos belonging to users who connected their account to your app — the right tool for a creator dashboard, useless for analysing a category. The Research API covers public video data properly and is limited to approved academic institutions. Between those sits every marketing team that needs engagement metrics on competitors' content and on creators they are considering paying.

For a dataset the decisive property is exactness. TikTok's interface abbreviates to 1.2M and 45.3K; the payload carries integers, and this delivers those. Engagement rate, share-to-view ratio and week-over-week deltas are all arithmetic on numbers that rounding would destroy.

Limits, failures and the legal bit

Up to 50 videos per run, public videos only. Private, removed and region-locked videos return under failed with TikTok's own reason and are never billed — a monitoring pipeline needs to tell "this was taken down" from "our fetch broke", because they mean different things. Throughput is your plan's rate limit rather than anything about the collector: 60 requests/minute on pay-as-you-go, up to 1,200 on the top tier.

Collecting publicly visible data is generally lawful in most jurisdictions, and courts have repeatedly declined to treat reading a public page as unauthorised access. Author fields identify people, which brings data-protection law into scope, and TikTok's terms restrict automated collection. Metadata only: no media is downloaded. None of this is legal advice — get some for your actual use case.

TikTok video scraper API: the POST to the tiktok_video collector, 5 videos delivered and the bill, 5 × $0.004 = $0.02 in usage.cost_usd; zero videos would cost $0. — The same call you would paste into a terminal: a Bearer key, videos and country in the body, and back the envelope every QuanticData endpoint returns — type, message, payload — where count is how many videos arrived and usage.cost_usd is $0.02, which is 5 × $0.004. A run that delivers nothing costs nothing. The key is good for 60 req/min on the free tier.

Sources and standards

The platform documentation and standards this collector is built against — check any claim on this page against the primary source:

FAQ

Questions we get about the TikTok video scraper API.

Something else? Ask us

What input does it take?

Full video URLs or bare numeric ids — up to 50 per run, fetched three at a time.

Why did a video come back as failed?

Because TikTok reported it as unavailable: removed, private or blocked in the exit country. The reason is TikTok's own message, passed through verbatim, and the row is not charged.

Is there a free TikTok video scraper API?

Every account gets $2 of credit every month with no card, which is about 500 delivered videos on this endpoint at $0.004 each. It renews monthly, and a run that delivers nothing is never billed — so a failed or blocked attempt does not eat the allowance.

How much does one run cost?

Multiply the rows you actually receive by $0.004. A run capped at 50 videos — the maximum for this collector — costs $0.2 if every row comes back, and less when the source has fewer. Volume tiers take up to 30% off, and GET /v1/scraper/collectors returns the price your key actually pays.

What is the saves field good for?

It is TikTok's bookmark count, and it is the strongest intent signal on the platform — a save means someone means to come back. Ranking a content set by saves surfaces genuinely different videos than ranking by likes.

How do removed videos appear?

Under failed, with the platform's own reason attached, and unbilled. Keeping them separate from delivered rows is what lets a scheduled job distinguish a takedown from a transient error.

Run the TikTok video scraper API now

$2 of free credit every month, no card. Your key returns its own prices from GET /v1/scraper/collectors.

Run in dashboard

Illustration: three coloured zones of the page that is read (TikTok video page) turn into clean JSON with the fields author_name, description and created_at; 39 fields on every row.