TikTok scraper API
TikTok scraper API for videos, profiles, comments and hashtags
Get a public video with its counts and media, a profile with exact follower and like counts, search results, a hashtag and its recent videos, or a video’s comments, as structured JSON.
- Data from TikTok
$4.00 per 1,000 calls with a credit pack, down to $1.33 on the Business plan
7,500 credits, one-time. No subscription. Failed calls are free. The free trial covers the travel endpoints and 10 calls to the rest.
Endpoints and prices checked against the API on .
Every API on one keyTikTok’s own APIs need an approved app and cover your own account. This API reads what any visitor can see on TikTok and returns it with named fields, so you can track creators, follow a hashtag or study the comments on a video.
Counts are exact, not rounded: a profile shows 162,955,838 followers rather than 163M. A missing video, account or hashtag answers 404 and costs nothing.
What you get
- id, description, create_time
- the video, its caption and when it was posted
- plays, likes, comments, shares
- the video’s counts
- video_url, duration, covers
- the media, its length and its cover images
- hashtags, music
- the tags in the caption, and the sound with its author
- unique_id, nickname, verified, private
- who a profile is, and whether it is verified or private
- followers, following, hearts, videos_count
- a profile’s exact counts
- video_count, view_count
- a hashtag’s exact video and view counts
- comments[].text, likes, replies
- each comment, its likes and how many replies it has
One call, structured JSON
POST /v1/tiktok/video, 2 credits per successful call.
curl -X POST "https://api.scrapercompany.com/v1/tiktok/video" \
-H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "string"
}'{
"search_parameters": {
"engine": "tiktok_video",
"url": "https://www.tiktok.com/@scout2015/video/6718335390845095173"
},
"video": {
"id": "6718335390845095173",
"description": "Scramble up ur name & I'll try to guess it #foryoupage #petsoftiktok",
"created_at": "2019-07-27T13:32:38+00:00",
"duration": 10,
"width": 576,
"height": 1024,
"video_url": "https://v16m.tiktokcdn.com/…/video.mp4",
"cover": "https://p16-common-sign.tiktokcdn.com/…/cover.jpeg",
"covers": [
"https://p16-common-sign.tiktokcdn.com/…/cover.jpeg"
],
"image_urls": [],
"plays": 102300000,
"likes": 7100000,
"comments": 24000,
"shares": 38000,
"hashtags": [
"foryoupage",
"petsoftiktok"
],
"is_ad": false,
"location": "US",
"author": {
"unique_id": "scout2015",
"nickname": "Scout, Suki & Stella",
"sec_uid": "MS4wLjABAAAA…",
"user_id": "53279706535428096",
"signature": "Click follow to join the PAWsitive Pack",
"verified": true,
"avatar": "https://p16-common-sign.tiktokcdn.com/…/a.jpg",
"followers": 9000000,
"following": 1174,
"hearts": 108300000,
"videos": 3079
},
"music": {
"music_id": "6689804660171082501",
"title": "original sound",
"author": "tiff",
"original": true,
"play_url": "https://v58.tiktokcdn.com/…/audio.mp3"
}
}
}Every field, documented before you buy
What one POST /v1/tiktok/video call returns: 20 fields with their type and a value from the example above, then every input the call takes.
In the response
| Field | Type | Example | What it is |
|---|---|---|---|
| video | object | ||
| video.id | string | "6718335390845095173" | The site’s own id for the item. |
| video.description | string | "Scramble up ur name & I'll try to guess…" | Description text as the site shows it. |
| video.created_at | string | "2019-07-27T13:32:38+00:00" | When the item was created, as the site states it. |
| video.duration | integer | 10 | |
| video.width | integer | 576 | |
| video.height | integer | 1024 | |
| video.video_url | string | "https://v16m.tiktokcdn.com/…/video.mp4" | |
| video.cover | string | "https://p16-common-sign.tiktokcdn.com/……" | |
| video.covers | array | ||
| video.image_urls | array | ||
| video.plays | integer | 102300000 |
Show all 20 fields
| video.likes | integer | 7100000 | |
| video.comments | integer | 24000 | |
| video.shares | integer | 38000 | |
| video.hashtags | array | ||
| video.is_ad | boolean | false | |
| video.location | string | "US" | Location as the site gives it. |
| video.author | object | Author as the site names them. | |
| video.music | object |
Arrays show their first item; every item has the same fields. Full schema in the API reference
In the request
| Input | Type | Required | What it does |
|---|---|---|---|
| url | string | Yes | A TikTok video URL or its numeric id.Min length 3, max length 500. |
Endpoints and price per call
Credits per successful call, and what 1,000 calls cost: from a credit pack down to the Business plan. Failed requests cost nothing.
| Endpoint | What it returns | Credits | Per 1,000 calls |
|---|---|---|---|
| Video POST /v1/tiktok/video | One public video by URL or id | 2 credits | $4.00 – $1.33 |
| Profile POST /v1/tiktok/profile | One profile by handle, with its recent videos | 3 credits | $6.00 – $2.00 |
| Search POST /v1/tiktok/search | Videos for a search query | 3 credits | $6.00 – $2.00 |
| Hashtag POST /v1/tiktok/hashtag | A hashtag’s header and recent videos | 3 credits | $6.00 – $2.00 |
| Comments POST /v1/tiktok/comments | A video’s comments | 3 credits | $6.00 – $2.00 |
Your first call in three steps
- 01
Get an API key
Create an account and verify your email, then copy a key from the dashboard. The free trial is 50 calls or 14 days, whichever ends first, no card needed.
- 02
Send POST /v1/tiktok/video
Put the key in the
x-api-keyheader and passurl. Every other input is optional and listed above. - 03
Read the JSON
The answer is one JSON object with
video, typed and named the same way on every call. A failed call costs 0 credits, so retrying is free.
Limits and coverage
- Where it works
- Worldwide, public content only
- Counts are exact, such as 162,955,838 followers, not rounded to 163M.
- Some hashtags withhold their videos from logged-out visitors. You then get the header with no videos, and the call is free.
- Search returns videos. Users appear only when TikTok includes them.
- A missing video, account or hashtag answers 404 and is free.
Is it legal to scrape TikTok?
It depends on what you collect and what you do with it. Here is what the API does, and what stays with you once the data is yours.
Public pages only
The API reads what TikTok shows anyone who opens the page without signing in. It uses no account and opens nothing behind a paywall.
Facts are not the same as content
A price on a date, a rating or a count is a fact, and copyright does not protect facts. Review text, photos, descriptions and transcripts belong to their authors or the site. Counting, scoring or summarising them is a different use from republishing them, and republishing usually needs permission.
Databases have their own right in the EU and UK
Whoever invested in building a database there can stop others taking a substantial part of it, and repeated extraction of small parts can add up to a substantial part. Collect the fields and dates you need, not a copy of TikTok.
Personal data is yours to handle
Videos, comments and transcripts carry creators’ and commenters’ names and handles. If you keep it, the GDPR and UK GDPR apply to people in Europe and the UK, and other places have their own privacy laws: you need a lawful basis, must tell people you hold their data unless an exemption applies, should collect no more than you need, and should delete it on a schedule. The simplest route is not to keep it: drop names and handles before you store anything. A hashed name is still personal data.
The site’s terms, and ours
The terms of use of TikTok may limit automated access to it or reuse of its data. Our Terms make you responsible for how you use the data you collect, for following the terms of the sites it comes from, for data protection law, and for having the rights you need.
This is general information, not legal advice. For a specific use, ask a lawyer where you operate. TikTok is a trademark of its owner. ScraperCompany is independent: not affiliated with or endorsed by TikTok, and this is not an official TikTok API.
Frequently asked questions
Read next
Guides
Does TikTok have a public API for this?
TikTok’s APIs are for approved apps and mostly cover your own account. This API is independent of TikTok and returns public content as JSON, with no TikTok account or app review.
Why does a hashtag sometimes come back with no videos?
TikTok withholds the video list for some hashtags from visitors who are not logged in. You still get the hashtag’s title, description and counts, and that call is free.
Does search return accounts too?
Search returns videos. Accounts appear only when TikTok includes them in the results, which is rare. To get an account, look it up by handle with the profile call.
What does a call cost?
2 credits for a video. A profile is held at 3 and usually charged 2. Search, a hashtag and comments are 3. A missing video, account or hashtag, an empty answer and any failed call are free.
Can I get private accounts or content?
No. Only public content is returned. A private account comes back with private set to true and none of its videos.
Do failed requests cost credits?
No. A failed or blocked call (any 4xx or 5xx response) costs 0 credits, and so does a search page that comes back empty. You pay only for successful results.
How do I get an API key?
Create an account on the sign-up page and verify your email. You get a free trial of 50 calls or 14 days, whichever ends first, no card needed on the travel endpoints (hotels, vacation rentals, flights, reviews) and 10 calls to the other sources; for everything else, and after the trial, buy a credit pack (from $15) or pick a plan. You create and rotate keys yourself in the dashboard.
More APIs on the same key
All APIsGet a public video’s transcript as timed segments, its comments, its metadata and chapters, plus search results and channel pages. Structured JSON from one key, with no Google Cloud project and no Data API quota.
Send a URL, get the page back as HTML, markdown or text. If an attempt does not return the page, the request is tried again automatically, and you pay only for a page that comes back with content.
Send a URL, get back an image of the page as a visitor sees it, after its JavaScript has run and its images have loaded. Pick the size, the format and what to capture: the viewport, the whole page or one element.
Look up any US tail number and get the FAA’s public record as JSON, or search the whole registry by owner, manufacturer, model, place or year: owner, airframe, engine and certificate dates, plus recent document receipts.
Start with 50 free calls
Create an account and verify your email: your own API keys and a free trial of 50 calls or 14 days, whichever ends first, no card needed. Then buy a credit pack from $15 or pick a plan from $49 a month.
7,500 credits, one-time. No subscription. Or try it free: 50 calls, no card.
- See pricingPlans, packs and every price
- Talk to salesVolume, custom terms, invoices
- Read the quickstartFirst call in five minutes