Skip to main content
GET
/
v1
/
results
Get Results
curl --request GET \
  --url https://api.lobstr.io/v1/results \
  --header 'Authorization: <authorization>'
{
  "video_id": "<string>",
  "description": "<string>",
  "created_at": "<string>",
  "play_count": 123,
  "like_count": 123,
  "comment_count": 123,
  "share_count": 123,
  "collect_count": 123,
  "repost_count": 123,
  "duration": 123,
  "width": 123,
  "height": 123,
  "definition": "<string>",
  "bitrate": 123,
  "file_size": 123,
  "is_ad": true,
  "duet_enabled": true,
  "stitch_enabled": true,
  "location_created": "<string>",
  "play_url": "<string>",
  "download_url": "<string>",
  "cover_url": "<string>",
  "dynamic_cover": "<string>",
  "music_id": "<string>",
  "music_title": "<string>",
  "music_author": "<string>",
  "music_play_url": "<string>",
  "music_duration": 123,
  "music_original": true,
  "music_is_copyrighted": true,
  "author_id": "<string>",
  "author_sec_uid": "<string>",
  "author_username": "<string>",
  "author_nickname": "<string>",
  "author_verified": true,
  "author_bio": "<string>",
  "author_follower_count": 123,
  "author_following_count": 123,
  "author_total_likes": 123,
  "author_video_count": 123,
  "author_avatar": "<string>",
  "is_related": true,
  "related_to_video_id": "<string>",
  "input_video_url": "<string>",
  "scraping_time": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve scraped data from your TikTok Video Scraper runs.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

​
Query Parameters

​
squid
string
required
Hash of the squid to get results from.
​
run
string
Hash of a specific run (optional).
​
page
integer
Page number (default: 1).
​
limit
integer
Results per page (default: 50, max: 100).

​
Result Fields

​
video_id
string
Unique TikTok identifier for the video. Example: 6862153058223197445
​
description
string
Caption/description text of the video.
​
created_at
string
ISO 8601 timestamp of when the video was published. Example: 2020-08-17T12:34:56Z
​
play_count
integer
Total number of plays/views. Example: 52300000
​
like_count
integer
Total number of likes. Example: 3100000
​
comment_count
integer
Total number of comments. Example: 45000
​
share_count
integer
Number of times the video was shared. Example: 120000
​
collect_count
integer
Number of times the video was saved/collected. Example: 870000
​
repost_count
integer
Number of reposts. Example: 0
​
duration
integer
Video duration in seconds. Example: 15
​
width
integer
Video width in pixels. Example: 576
​
height
integer
Video height in pixels. Example: 1024
​
definition
string
Video quality definition. Example: 540p
​
bitrate
integer
Video bitrate. Example: 1243660
​
file_size
integer
File size in bytes. Example: 2330107
​
is_ad
boolean
Whether the video is an advertisement. Example: false
​
duet_enabled
boolean
Whether duets are enabled for this video. Example: true
​
stitch_enabled
boolean
Whether stitches are enabled for this video. Example: true
​
location_created
string
Country code where the video was created. Example: US
​
play_url
string
URL to stream the video.
​
download_url
string
URL to download the video.
​
cover_url
string
URL of the video thumbnail/cover image.
​
dynamic_cover
string
URL of the animated cover image.
​
music_id
string
Unique identifier for the music track used. Example: 6862153058223197445
​
music_title
string
Title of the music track. Example: M to the B
​
music_author
string
Artist name of the music track. Example: Millie B
​
music_play_url
string
URL to play the music track.
​
music_duration
integer
Duration of the music track in seconds. Example: 60
​
music_original
boolean
Whether the audio is the creator’s original sound. Example: false
​
music_is_copyrighted
boolean
Whether the music track is copyrighted. Example: true
​
author_id
string
Unique TikTok user ID of the video author. Example: 6569595380449902597
​
author_sec_uid
string
Secondary unique identifier for the author’s account.
​
author_username
string
TikTok username (handle) of the author. Example: bellapoarch
​
author_nickname
string
Display name of the author. Example: Bella Poarch
​
author_verified
boolean
Whether the author’s account is verified. Example: true
​
author_bio
string
Bio/description from the author’s profile.
​
author_follower_count
integer
Number of followers the author has. Example: 92800000
​
author_following_count
integer
Number of accounts the author follows. Example: 728
​
author_total_likes
integer
Total likes received across all the author’s videos. Example: 2200000000
​
author_video_count
integer
Total number of videos published by the author. Example: 421
​
author_avatar
string
URL of the author’s profile picture.
​
is_related
boolean
Whether this result is a related video (not directly from a task URL). Example: false
​
related_to_video_id
string
The video ID of the task that triggered this related result. Only set when is_related is true.
​
input_video_url
string
The original task URL that produced this result.
​
scraping_time
string
ISO 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&limit=50" \
  -H "Authorization: Token YOUR_API_KEY"

​
Response

200
{
  "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
}