> ## 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. # Get Results > Retrieve scraped data from TikTok Video Scraper Retrieve scraped data from your **TikTok Video Scraper** runs. ## Headers Your API authentication token. Value: `Token YOUR_API_KEY` ## Query Parameters Hash of the squid to get results from. Hash of a specific run (optional). Page number (default: 1). Results per page (default: 50, max: 100). ## Result Fields Unique TikTok identifier for the video. Example: `6862153058223197445` Caption/description text of the video. ISO 8601 timestamp of when the video was published. Example: `2020-08-17T12:34:56Z` Total number of plays/views. Example: `52300000` Total number of likes. Example: `3100000` Total number of comments. Example: `45000` Number of times the video was shared. Example: `120000` Number of times the video was saved/collected. Example: `870000` Number of reposts. Example: `0` Video duration in seconds. Example: `15` Video width in pixels. Example: `576` Video height in pixels. Example: `1024` Video quality definition. Example: `540p` Video bitrate. Example: `1243660` File size in bytes. Example: `2330107` Whether the video is an advertisement. Example: `false` Whether duets are enabled for this video. Example: `true` Whether stitches are enabled for this video. Example: `true` Country code where the video was created. Example: `US` URL to stream the video. URL to download the video. URL of the video thumbnail/cover image. URL of the animated cover image. Unique identifier for the music track used. Example: `6862153058223197445` Title of the music track. Example: `M to the B` Artist name of the music track. Example: `Millie B` URL to play the music track. Duration of the music track in seconds. Example: `60` Whether the audio is the creator's original sound. Example: `false` Whether the music track is copyrighted. Example: `true` Unique TikTok user ID of the video author. Example: `6569595380449902597` Secondary unique identifier for the author's account. TikTok username (handle) of the author. Example: `bellapoarch` Display name of the author. Example: `Bella Poarch` Whether the author's account is verified. Example: `true` Bio/description from the author's profile. Number of followers the author has. Example: `92800000` Number of accounts the author follows. Example: `728` Total likes received across all the author's videos. Example: `2200000000` Total number of videos published by the author. Example: `421` 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`. The original task URL that produced this result. ISO 8601 timestamp of when this result was scraped. ## Code Examples ```bash cURL theme={null} curl -X GET "https://api.lobstr.io/v1/results?squid=YOUR_SQUID_HASH&page=1&limit=50" \ -H "Authorization: Token YOUR_API_KEY" ``` ```python Python theme={null} 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 ```json 200 theme={null} { "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 } ```