Skip to content
Examples

Get Results

Retrieve scraped data from TikTok Hashtag 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 Hashtag 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

hashtagstring

The hashtag this video was collected from (without the leading #). Example: lobstr

hashtag_rankinteger

Position of this video in the hashtag's video feed at scrape time. Example: 1

video_idstring

Unique TikTok video identifier. Example: 7680941891700935944

descriptionstring

Caption or description of the TikTok video. Example: GoPro POV: I found a party inside the lobster den #lobster #underwater #pov #party #higgsfield

text_languagestring

Detected language code of the video's caption. Example: en

hashtagsjson

List of hashtags used in the video's own caption. Example: ["lobster", "underwater", "pov", "party", "higgsfield"]

mentionsjson

List of TikTok accounts (@mentions) tagged in the video's caption. Example: []

created_atdatetime

Date and time the video was published. Example: 2026-09-02T12:17:29Z

play_countinteger

Total number of times the video has been played. Example: 1500000

like_countinteger

Total number of likes on the video. Example: 60900

comment_countinteger

Total number of comments on the video. Example: 662

share_countinteger

Total number of times the video has been shared. Example: 23300

collect_countinteger

Total number of times the video has been saved to collections. Example: 4940

repost_countinteger

Total number of times the video has been reposted. Example: 0

durationinteger

Duration of the video in seconds. Example: 12

widthinteger

Width of the video in pixels. Example: 576

heightinteger

Height of the video in pixels. Example: 1024

definitionstring

Video resolution definition (e.g. 540p, 720p, 1080p). Example: 540p

video_formatstring

Container format of the video file. Example: mp4

bitrateinteger

Video bitrate in bits per second. Example: 641117

file_sizeinteger

File size of the video in bytes. Example: 988443

is_adboolean

Whether the video is a paid advertisement. Example: False

duet_enabledboolean

Whether the author has enabled duets for this video. Example: True

stitch_enabledboolean

Whether the author has enabled stitches for this video. Example: True

location_createdstring

ISO country code of where the video was created.

video_urlstring

Canonical TikTok video page URL. Unlike play_url/download_url (signed CDN links tied to the proxy IP that fetched them, and unusable elsewhere), this always works. Example: https://www.tiktok.com/@kennyslowbird/video/7680941891700935944

play_urlstring

Direct streaming URL for the video. Signed and tied to the proxy IP that fetched it -- confirmed to 403 from any other network, even with full browser TLS impersonation. Use video_url for a link guaranteed to keep working. Example: https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/osPMAPFpquB5whsYB2iigfBnEmARMIREIyfDUC/?a=1988&bti=ODszNWYuMDE6&&bt=626&ft=-Csk_m.MPD12NpP3Jn-Uxl7FSY3W3wv25ycAp&mime_type=video_mp4&rc=NmQ6Mzk5ODNkZDs7ZGk7N0BpajRqNnA5cm01ZDMzODczNEBiLjIxX19eNl4xLl40YmIwYSNoNHFtMmRzc2BhLS1kMTFzcw%3D%3D&expire=1788988144&l=202609072108521145CE1BA5A6675D4565&ply_type=2&policy=2&signature=3a1dd0cf1932bd6dffda58177499342f&tk=tt_chain_token&btag=e000b0000

download_urlstring

Direct download URL for the video. Same IP-binding limitation as play_url -- use video_url for a link guaranteed to keep working.

cover_urlstring

URL of the video thumbnail (cover image). Example: https://p19-common-sign.tiktokcdn-eu.com/tos-alisg-p-0037/ocGMEGfYAbdQDHfqSLQLI8HYQFfesTwwcAGXRI~tplv-tiktokx-origin.image?dr=10395&x-expires=1788987600&x-signature=o7cWRDAV2XzbPvIXQ%2FcYS24BwIc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a

dynamic_coverstring

URL of the animated dynamic cover (GIF-like preview). Example: https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-p-0037/o4QwQEGJGXYYAyGqILEReDTfS8bRfIjAQHLfF2~tplv-tiktokx-origin.image?dr=10395&x-expires=1788987600&x-signature=mzIZiNAQrJvIOm40dm1XaHHQpvU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a

music_idstring

Unique identifier of the music track used in the video. Example: 7639424214639167489

music_titlestring

Title of the music track used in the video. Example: Movin' To The Sun

music_authorstring

Artist name of the music track used in the video. Example: HUGEL & Imael Angel & Ultra Naté

music_play_urlstring

Direct URL to stream the audio track. Example: https://sf16-music.tiktokcdn-eu.com/obj/tos-alisg-ve-2774/owYPQBSopi5XcEAa58MUvAixnPAWIp93tiLnr

music_cover_urlstring

URL of the music track's cover art. Example: https://p77-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/oYmBAs9EvpUPMEAiAHxSsYrqAWiBAmAQCawAV.jpeg

music_durationinteger

Duration of the music track in seconds. Example: 48

music_originalboolean

Whether the audio is an original sound created by the author. Example: False

music_is_copyrightedboolean

Whether the music track is under copyright protection. Example: False

author_idstring

Unique numeric identifier of the video author. Example: 6829825193482929158

author_sec_uidstring

Secondary unique identifier of the author (used in API calls). Example: MS4wLjABAAAAzeLkt1OZZGvXNE4urbCiOvdjecJhZuPMjTzCM_RZYVnW9gG0AiIOEQiv7u75lmX0

author_usernamestring

TikTok username (handle) of the video author. Example: kennyslowbird

author_nicknamestring

Display name of the video author. Example: Kenny

author_verifiedboolean

Whether the author's account is verified by TikTok. Example: False

author_private_accountboolean

Whether the author's account is set to private. Example: False

author_biostring

Biography or description on the author's TikTok profile Example: ⬆️ 2.7 million across all platforms 🔥Music Release & Collabs & partnerships🔥 📩 kennyslowbird@gmail.com 📩 🔥 Higgsfield Partner 🔥 ⬇️ buy my secret ⬇️

author_follower_countinteger

Number of followers the author has. Example: 1700000

author_following_countinteger

Number of accounts the author is following. Example: 381

author_total_likesinteger

Total likes received by the author across all their videos. Example: 67900000

author_video_countinteger

Total number of videos published by the author. Example: 1893

author_digg_countinteger

Total number of likes the author has given to other videos. Example: 2209

author_friend_countinteger

Number of mutual followers (friends) the author has. Example: 0

author_avatarstring

URL of the author's profile picture. Example: https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/a0d2d60a3d45a05ea7d2220c875cba22~tplv-tiktokx-cropcenter:100:100.jpeg?dr=10399&refresh_token=3b6951e9&x-expires=1788987600&x-signature=MP2LVGgC8j02XYhQROa%2BKDQ00HE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a

effect_stickersjson

List of visual effects/stickers applied to the video. Example: [{"id": "1911622141", "name": "IPHONE EVENING CAPTURE", "use_count": 0}, {"id": "127702155", "name": "comfy", "use_count": 0}]

scraping_timedatetime

Date and time when this video was scraped. Example: 2026-09-07T21:09:20.934Z

Code Examples

curl -G https://api.lobstr.io/v1/results \
  -H "Authorization: Token YOUR_API_KEY" \
  -d "squid=YOUR_SQUID_HASH" \
  -d "page=1"

Response

200
{"total_results": 1, "data": [{"hashtag": "lobstr", "hashtag_rank": 1, "video_id": "7680941891700935944", "description": "GoPro POV: I found a party inside the lobster den #lobster #underwater #pov #party #higgsfield ", "text_language": "en", "hashtags": ["lobster", "underwater", "pov", "party", "higgsfield"], "mentions": [], "created_at": "2026-09-02T12:17:29Z", "play_count": 1500000, "like_count": 60900}]}