Skip to content
Examples

Get Results

Retrieve scraped data from TikTok Profile Scraper

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your TikTok Profile Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

pageintegerquery

Page number (default: 1)

Result Fields

video_rankinteger

Position of this video in the profile's feed at scrape time

video_idstring

Unique TikTok video identifier. Example: 7123456789012345678

descriptionstring

Caption of the TikTok video. Example: Crazy experiment gone wrong!

text_languagestring

Detected language code of the caption

hashtagsjson

Hashtags in the caption

mentionsjson

@-mentions in the caption

created_atdatetime

Date and time the video was published (UTC). Example: 2026-09-12T18:00:00Z

play_countbigint

Total number of plays. Example: 45000000

like_countbigint

Total number of likes. Example: 3200000

comment_countbigint

Total number of comments

share_countbigint

Total number of shares

collect_countbigint

Total number of saves to collection

repost_countbigint

Total number of reposts

durationinteger

Duration of the video in seconds

widthinteger

Width of the video in pixels

heightinteger

Height of the video in pixels

definitionstring

Video resolution. Example: 1080p

video_formatstring

Container format of the video file

bitrateinteger

Video bitrate in bits per second

file_sizebigint

File size in bytes

is_adboolean

Whether the video is a paid advertisement

is_slideshowboolean

True when the post is a photo slideshow

slideshow_image_urlsjson

Ordered list of image URLs when is_slideshow is true

duet_enabledboolean

Whether the author has enabled duets

stitch_enabledboolean

Whether the author has enabled stitches

location_createdstring

ISO country code of where the video was created

video_urlstring

Canonical TikTok video page URL

play_urlstring

Direct streaming URL (signed, tied to the proxy)

download_urlstring

Direct download URL (signed, tied to the proxy)

cover_urlstring

URL of the video thumbnail

origin_coverstring

Original unprocessed cover image URL

dynamic_coverstring

URL of the animated dynamic cover

subtitlesjson

Subtitle/caption tracks available for the video

effect_stickersjson

Visual effects/stickers applied to the video

music_idstring

Unique identifier of the music track

music_titlestring

Title of the music track

music_authorstring

Artist name of the music track

music_play_urlstring

Direct URL to stream the audio track

music_cover_urlstring

URL of the music track's cover art

music_durationinteger

Duration of the music track in seconds

music_originalboolean

Whether the audio is an original sound

music_is_copyrightedboolean

Whether the music track is under copyright

author_idstring

TikTok numeric user id of the profile

author_sec_uidstring

TikTok secUid of the profile

author_usernamestring

Profile handle (uniqueId), lowercase, without @. Example: mrbeast

author_nicknamestring

Display name of the profile

author_biostring

Profile bio

author_bio_linkstring

External link in the profile bio

author_avatarstring

Profile picture URL

author_verifiedboolean

Whether the profile carries TikTok's verified badge

author_private_accountboolean

Whether the profile is private

author_follower_countbigint

Number of followers. Example: 200000000

author_following_countbigint

Number of accounts followed

author_total_likesbigint

Total likes received by the profile

author_video_countbigint

Number of videos on the profile

author_friend_countbigint

Number of mutual follows

author_digg_countbigint

Number of likes the profile has given

author_is_commerce_userboolean

Whether flagged as commerce account

author_tt_sellerboolean

Whether profile is a TikTok Shop seller

author_is_organizationboolean

Whether flagged as organization account

author_room_idstring

Id of the profile's live room

author_created_atdatetime

Date and time the TikTok account was created

author_languagestring

Profile's interface language code

author_profile_urlstring

Canonical TikTok profile URL

source_urlstring

The profile URL or handle given as task input

scraping_timedatetime

Date and time when this row was scraped

Response

200
{"total_results": 1, "data": [{"video_id": "7123456789012345678", "description": "Crazy experiment gone wrong!", "play_count": 45000000, "like_count": 3200000, "author_username": "mrbeast", "author_follower_count": 200000000, "created_at": "2026-09-12T18:00:00Z"}]}