How to Scrape Tiktok Keyword Search Results
This tutorial shows how to use Tiktok Keyword Search Results API to scrape and crawl structured Tiktok data in real-time.
Query TikTok's content library by any keyword and get back ranked videos, creator profiles, and trending topic data all in a single API call.
Access Tiktok Data in 3 Steps
Start crawling Tiktok keyword search data. Follow these steps to extract social media data in minutes.
Create Your Account
Go to our registration page and make an account. It's free, no credit card, and you get credits right away to play around with.
Verify Your Email Address
You'll get a verification email, click the link in it. Once that's done, you can grab your API token from the dashboard.
Make Your First API Call
Copy the code snippet below, swap in your API key, and run it. You'll get Tiktok data back as JSON within a few seconds.
Code Sample
Here's a JavaScript example to get you going. Swap out the token and you're good, works the same way in any language that can make HTTP requests. Start collecting keyword search data via our REST API!
| 1 | const root = 'https://ensembledata.com/apis' |
| 2 | const endpoint = '/tt/keyword/search' |
| 3 | const params = { |
| 4 | "name": "tesla", |
| 5 | "cursor": 0, |
| 6 | "period": "1", |
| 7 | "sorting": "0", |
| 8 | "country": "us", |
| 9 | "match_exactly": false, |
| 10 | "get_author_stats": false, |
| 11 | "token": "YOUR-TOKEN-HERE" |
| 12 | } |
| 13 | |
| 14 | const queryString = new URLSearchParams(params).toString(); |
| 15 | const url = `${root}${endpoint}?${queryString}`; |
| 16 | |
| 17 | await fetch(url) |
| 18 | .then(response => response.json()) |
| 19 | .then(data => console.log(data)) |
| 20 | .catch(error => console.error(error)); |
| 21 |
Parameters
Example Response
Explore the fields returned by this endpoint. Click a row to expand nested objects and arrays, hover a value to copy it, or use "Expand all" to see everything at once.
dataobject2 fields
dataarray1 item · schema from #0 1 item
aweme_infoobject84 fields
risk_infosobject5 fields
label_topobject4 fields
url_listarray1 item · schema from #0 1 item
videoobject26 fields
coverobject4 fields
url_listarray2 items · schema from #0 2 items
origin_coverobject4 fields
url_listarray3 items · schema from #0 3 items
download_addrobject5 fields
url_listarray3 items · schema from #0 3 items
dynamic_coverobject4 fields
url_listarray2 items · schema from #0 2 items
play_addr_bytevc1object8 fields
url_listarray3 items · schema from #0 3 items
big_thumbsarray0 items
ai_dynamic_coverobject2 fields
url_listarray2 items · schema from #0 2 items
play_addr_h264object8 fields
url_listarray3 items · schema from #0 3 items
animated_coverobject2 fields
url_listarray2 items · schema from #0 2 items
play_addrobject8 fields
url_listarray3 items · schema from #0 3 items
bit_ratearray4 items · schema from #0 4 items
play_addrobject8 fields
url_listarray3 items · schema from #0 3 items
ai_dynamic_cover_bakobject2 fields
url_listarray2 items · schema from #0 2 items
group_id_listobject2 fields
statisticsobject11 fields
video_labelsarray0 items
aweme_aclobject5 fields
download_generalobject4 fields
download_mask_panelobject4 fields
share_generalobject4 fields
mask_infosarray0 items
search_highlightarray1 item · schema from #0 1 item
positionsarray1 item · schema from #0 1 item
text_extraarray11 items · schema from #0 11 items
share_infoobject13 fields
video_textarray0 items
cha_listarray1 item · schema from #0 1 item
authorobject24 fields
share_infoobject11 fields
extra_attrobject1 field
connect_musicarray0 items
musicobject50 fields
cover_mediumobject4 fields
url_listarray1 item · schema from #0 1 item
play_urlobject4 fields
url_listarray1 item · schema from #0 1 item
artistsarray0 items
duration_high_precisionobject4 fields
strong_beat_urlobject4 fields
url_listarray1 item · schema from #0 1 item
cover_thumbobject4 fields
url_listarray1 item · schema from #0 1 item
matched_songobject7 fields
chorus_infoobject2 fields
cover_mediumobject4 fields
url_listarray1 item · schema from #0 1 item
cover_largeobject4 fields
url_listarray1 item · schema from #0 1 item
external_song_infoarray0 items
commerce_infoobject3 fields
statusobject11 fields
review_resultobject1 field
interaction_stickersarray9 items · schema from #0 9 items
text_sticker_infoobject7 fields
video_controlobject11 fields
content_desc_extraarray0 items
authorobject114 fields
cover_urlarray1 item · schema from #0 1 item
url_listarray1 item · schema from #0 1 item
avatar_largerobject4 fields
url_listarray2 items · schema from #0 2 items
avatar_thumbobject4 fields
url_listarray2 items · schema from #0 2 items
video_iconobject4 fields
url_listarray0 items
share_infoobject8 fields
share_qrcode_urlobject4 fields
url_listarray0 items
avatar_168x168object4 fields
url_listarray2 items · schema from #0 2 items
special_accountobject1 field
avatar_300x300object4 fields
url_listarray2 items · schema from #0 2 items
avatar_mediumobject4 fields
url_listarray2 items · schema from #0 2 items
Response Codes
Status codes this endpoint can return, so you can handle errors before they surprise you in production.
API Pricing
Fetch Tiktok Data at Scale
Search TikTok content at scale and identify relevant creators and trending topics before your competitors do.
Ranked Results
Get ranked videos and creators for any TikTok search term instantly.
Creator Search
Find niche creators currently ranking for your target keywords.
Topic Discovery
Surface trending topics your target audience is actively watching.