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

GET

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_KEY

Query 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: 6862153058223197445

string

Caption/description text of the video.

string

ISO 8601 timestamp of when the video was published. Example: 2020-08-17T12:34:56Z

integer

Total number of plays/views. Example: 52300000

integer

Total number of likes. Example: 3100000

integer

Total number of comments. Example: 45000

Number of times the video was shared. Example: 120000

integer

Number of times the video was saved/collected. Example: 870000

integer

Number of reposts. Example: 0

integer

Video duration in seconds. Example: 15

integer

Video width in pixels. Example: 576

integer

Video height in pixels. Example: 1024

string

Video quality definition. Example: 540p

integer

Video bitrate. Example: 1243660

integer

File size in bytes. Example: 2330107

boolean

Whether the video is an advertisement. Example: false

boolean

Whether duets are enabled for this video. Example: true

boolean

Whether stitches are enabled for this video. Example: true

string

Country code where the video was created. Example: US

string

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: 6862153058223197445

string

Title of the music track. Example: M to the B

string

Artist name of the music track. Example: Millie B

string

URL to play the music track.

integer

Duration of the music track in seconds. Example: 60

boolean

Whether the audio is the creator’s original sound. Example: false

boolean

Whether the music track is copyrighted. Example: true

string

Unique TikTok user ID of the video author. Example: 6569595380449902597

string

Secondary unique identifier for the author’s account.

string

TikTok username (handle) of the author. Example: bellapoarch

string

Display name of the author. Example: Bella Poarch

boolean

Whether the author’s account is verified. Example: true

string

Bio/description from the author’s profile.

integer

Number of followers the author has. Example: 92800000

integer

Number of accounts the author follows. Example: 728

integer

Total likes received across all the author’s videos. Example: 2200000000

integer

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

string

URL of the author’s profile picture.

Whether this result is a related video (not directly from a task URL). Example: false

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&limit=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,
    "limit": 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
}

Update Settings Add Tasks

​Headers

​Query Parameters

​Result Fields

​Code Examples

​Response

Headers

Query Parameters

Result Fields

Code Examples

Response