Get Results
curl --request GET \
--url https://api.lobstr.io/v1/results \
--header 'Authorization: <authorization>'import requests
url = "https://api.lobstr.io/v1/results"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.lobstr.io/v1/results', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lobstr.io/v1/results",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lobstr.io/v1/results"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.lobstr.io/v1/results")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lobstr.io/v1/results")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"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>"
}TikTok Video Scraper
Get Results
Retrieve scraped data from TikTok Video Scraper
GET
/
v1
/
results
Get Results
curl --request GET \
--url https://api.lobstr.io/v1/results \
--header 'Authorization: <authorization>'import requests
url = "https://api.lobstr.io/v1/results"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.lobstr.io/v1/results', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lobstr.io/v1/results",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lobstr.io/v1/results"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.lobstr.io/v1/results")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lobstr.io/v1/results")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"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>"
}Retrieve scraped data from your TikTok Video Scraper runs.
Headers
string
required
Your API authentication token. Value:
Token YOUR_API_KEYQuery Parameters
string
required
Hash of the squid to get results from.
string
Hash of a specific run (optional).
integer
Page number (default: 1).
integer
Results per page (default: 50, max: 100).
Result Fields
string
Unique TikTok identifier for the video. Example:
6862153058223197445string
Caption/description text of the video.
string
ISO 8601 timestamp of when the video was published. Example:
2020-08-17T12:34:56Zinteger
Total number of plays/views. Example:
52300000integer
Total number of likes. Example:
3100000integer
Total number of comments. Example:
45000integer
Number of times the video was shared. Example:
120000integer
Number of times the video was saved/collected. Example:
870000integer
Number of reposts. Example:
0integer
Video duration in seconds. Example:
15integer
Video width in pixels. Example:
576integer
Video height in pixels. Example:
1024string
Video quality definition. Example:
540pinteger
Video bitrate. Example:
1243660integer
File size in bytes. Example:
2330107boolean
Whether the video is an advertisement. Example:
falseboolean
Whether duets are enabled for this video. Example:
trueboolean
Whether stitches are enabled for this video. Example:
truestring
Country code where the video was created. Example:
USstring
URL to stream the video.
string
URL to download the video.
string
URL of the video thumbnail/cover image.
string
URL of the animated cover image.
string
Unique identifier for the music track used. Example:
6862153058223197445string
Title of the music track. Example:
M to the Bstring
Artist name of the music track. Example:
Millie Bstring
URL to play the music track.
integer
Duration of the music track in seconds. Example:
60boolean
Whether the audio is the creator’s original sound. Example:
falseboolean
Whether the music track is copyrighted. Example:
truestring
Unique TikTok user ID of the video author. Example:
6569595380449902597string
Secondary unique identifier for the author’s account.
string
TikTok username (handle) of the author. Example:
bellapoarchstring
Display name of the author. Example:
Bella Poarchboolean
Whether the author’s account is verified. Example:
truestring
Bio/description from the author’s profile.
integer
Number of followers the author has. Example:
92800000integer
Number of accounts the author follows. Example:
728integer
Total likes received across all the author’s videos. Example:
2200000000integer
Total number of videos published by the author. Example:
421string
URL of the author’s profile picture.
boolean
Whether this result is a related video (not directly from a task URL). Example:
falsestring
The video ID of the task that triggered this related result. Only set when
is_related is true.string
The original task URL that produced this result.
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&page_size=50" \
-H "Authorization: Token YOUR_API_KEY"
import requests
API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.lobstr.io/v1"
headers = {"Authorization": f"Token {API_KEY}"}
params = {
"squid": "YOUR_SQUID_HASH",
"page": 1,
"page_size": 50
}
all_results = []
url = f"{BASE_URL}/results"
while True:
response = requests.get(url, headers=headers, params=params)
data = response.json()
all_results.extend(data["data"])
print(f"Fetched page {data['page']} of {data['total_pages']}")
if data["next"] is None:
break
url = data["next"]
params = {}
print(f"\nTotal videos collected: {len(all_results)}")
for video in all_results[:5]:
print(f"- @{video.get('author_username')}: {video.get('description', '')[:60]} ({video.get('play_count', 0):,} plays)")
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
}