Skip to content
Examples

Get Results

Retrieve scraped data from TikTok Video 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 Video Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from.

runstringquery

Hash of a specific run (optional).

pageintegerquery

Page number (default: 1).

page_sizeintegerquery

Results per page (default: 50, max: 100).

Result Fields

video_idstring

Unique TikTok identifier for the video. Example: 6862153058223197445

descriptionstring

Caption/description text of the video.

created_atstring

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

play_countinteger

Total number of plays/views. Example: 52300000

like_countinteger

Total number of likes. Example: 3100000

comment_countinteger

Total number of comments. Example: 45000

share_countinteger

Number of times the video was shared. Example: 120000

collect_countinteger

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

repost_countinteger

Number of reposts. Example: 0

durationinteger

Video duration in seconds. Example: 15

widthinteger

Video width in pixels. Example: 576

heightinteger

Video height in pixels. Example: 1024

definitionstring

Video quality definition. Example: 540p

bitrateinteger

Video bitrate. Example: 1243660

file_sizeinteger

File size in bytes. Example: 2330107

is_adboolean

Whether the video is an advertisement. Example: false

duet_enabledboolean

Whether duets are enabled for this video. Example: true

stitch_enabledboolean

Whether stitches are enabled for this video. Example: true

location_createdstring

Country code where the video was created. Example: US

play_urlstring

URL to stream the video.

download_urlstring

URL to download the video.

cover_urlstring

URL of the video thumbnail/cover image.

dynamic_coverstring

URL of the animated cover image.

music_idstring

Unique identifier for the music track used. Example: 6862153058223197445

music_titlestring

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

music_authorstring

Artist name of the music track. Example: Millie B

music_play_urlstring

URL to play the music track.

music_durationinteger

Duration of the music track in seconds. Example: 60

music_originalboolean

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

music_is_copyrightedboolean

Whether the music track is copyrighted. Example: true

author_idstring

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

author_sec_uidstring

Secondary unique identifier for the author's account.

author_usernamestring

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

author_nicknamestring

Display name of the author. Example: Bella Poarch

author_verifiedboolean

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

author_biostring

Bio/description from the author's profile.

author_follower_countinteger

Number of followers the author has. Example: 92800000

author_following_countinteger

Number of accounts the author follows. Example: 728

author_total_likesinteger

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

author_video_countinteger

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

author_avatarstring

URL of the author's profile picture.

is_relatedboolean

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

related_to_video_idstring

The video ID of the task that triggered this related result. Only set when is_related is true.

input_video_urlstring

The original task URL that produced this result.

scraping_timestring

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"

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
}