Get Results
Retrieve scraped data from TikTok Video Scraper
https://api.lobstr.io/v1/resultsRetrieve scraped data from your TikTok Video Scraper runs.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Query Parameters
squidstringqueryrequiredHash of the squid to get results from.
runstringqueryHash of a specific run (optional).
pageintegerqueryPage number (default: 1).
page_sizeintegerqueryResults per page (default: 50, max: 100).
Result Fields
video_idstringUnique TikTok identifier for the video. Example: 6862153058223197445
descriptionstringCaption/description text of the video.
created_atstringISO 8601 timestamp of when the video was published. Example: 2020-08-17T12:34:56Z
play_countintegerTotal number of plays/views. Example: 52300000
like_countintegerTotal number of likes. Example: 3100000
comment_countintegerTotal number of comments. Example: 45000
share_countintegerNumber of times the video was shared. Example: 120000
collect_countintegerNumber of times the video was saved/collected. Example: 870000
repost_countintegerNumber of reposts. Example: 0
durationintegerVideo duration in seconds. Example: 15
widthintegerVideo width in pixels. Example: 576
heightintegerVideo height in pixels. Example: 1024
definitionstringVideo quality definition. Example: 540p
bitrateintegerVideo bitrate. Example: 1243660
file_sizeintegerFile size in bytes. Example: 2330107
is_adbooleanWhether the video is an advertisement. Example: false
duet_enabledbooleanWhether duets are enabled for this video. Example: true
stitch_enabledbooleanWhether stitches are enabled for this video. Example: true
location_createdstringCountry code where the video was created. Example: US
play_urlstringURL to stream the video.
download_urlstringURL to download the video.
cover_urlstringURL of the video thumbnail/cover image.
dynamic_coverstringURL of the animated cover image.
music_idstringUnique identifier for the music track used. Example: 6862153058223197445
music_titlestringTitle of the music track. Example: M to the B
music_authorstringArtist name of the music track. Example: Millie B
music_play_urlstringURL to play the music track.
music_durationintegerDuration of the music track in seconds. Example: 60
music_originalbooleanWhether the audio is the creator's original sound. Example: false
music_is_copyrightedbooleanWhether the music track is copyrighted. Example: true
author_idstringUnique TikTok user ID of the video author. Example: 6569595380449902597
author_sec_uidstringSecondary unique identifier for the author's account.
author_usernamestringTikTok username (handle) of the author. Example: bellapoarch
author_nicknamestringDisplay name of the author. Example: Bella Poarch
author_verifiedbooleanWhether the author's account is verified. Example: true
author_biostringBio/description from the author's profile.
author_follower_countintegerNumber of followers the author has. Example: 92800000
author_following_countintegerNumber of accounts the author follows. Example: 728
author_total_likesintegerTotal likes received across all the author's videos. Example: 2200000000
author_video_countintegerTotal number of videos published by the author. Example: 421
author_avatarstringURL of the author's profile picture.
is_relatedbooleanWhether this result is a related video (not directly from a task URL). Example: false
related_to_video_idstringThe video ID of the task that triggered this related result. Only set when is_related is true.
input_video_urlstringThe original task URL that produced this result.
scraping_timestringISO 8601 timestamp of when this result was scraped.
Code Examples
curl -X GET "https://api.lobstr.io/v1/results?squid=YOUR_SQUID_HASH&page=1&page_size=50" \ -H "Authorization: Token YOUR_API_KEY"
Response
{ "total_results": 2, "limit": 50, "page": 1, "total_pages": 1, "result_from": 1, "result_to": 2, "data": [ { "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4", "object": "result", "squid": "YOUR_SQUID_HASH", "run": "RUN_HASH", "video_id": "6862153058223197445", "description": "😛✌️ #fyp #foryou #foryoupage", "created_at": "2020-08-17T12:34:56Z", "play_count": 52300000, "like_count": 3100000, "comment_count": 45000, "share_count": 120000, "collect_count": 870000, "repost_count": 0, "duration": 15, "width": 576, "height": 1024, "definition": "540p", "is_ad": false, "duet_enabled": true, "stitch_enabled": true, "location_created": "US", "music_title": "M to the B", "music_author": "Millie B", "music_original": false, "music_is_copyrighted": true, "author_username": "bellapoarch", "author_nickname": "Bella Poarch", "author_verified": true, "author_follower_count": 92800000, "is_related": false, "related_to_video_id": null, "input_video_url": "https://www.tiktok.com/@bellapoarch/video/6862153058223197445", "scraping_time": "2026-03-20T09:15:00.000Z" } ], "next": null, "previous": null }