How to Scrape TikTok Tops with Ruby

Extract top data from TikTok

💎 Using Ruby

Overview

Learn how to scrape TikTok tops using Ruby. This comprehensive guide will walk you through the entire process, from setup to implementation.

What You'll Learn

  • • Setting up your development environment
  • • Installing the required HTTP client
  • • Authenticating with the ScrapeCreators API
  • • Making requests to TikTok
  • • Handling responses and errors
  • • Best practices for production use

What You'll Get

  • • Access to tops data
  • • JSON formatted responses
  • • Real-time data access
  • • Scalable solution
  • • Error handling patterns
  • • Performance optimization tips

Prerequisites

1. API Key

First, you'll need a ScrapeCreators API key to authenticate your requests.

Sign up at app.scrapecreators.com to get your free API key with 100 requests.

2. Development Environment

Make sure you have the following installed:

  • • Ruby and its dependencies
  • • A code editor (VS Code, Sublime, etc.)
  • • Basic understanding of API requests
  • • Command line interface access

Step 1: Install HTTP Client

HTTParty is a Ruby library that makes HTTP requests easy

gem
gem install httparty

Step 2: API Implementation

Now let's make a request to the TikTok API using Ruby. Replace YOUR_API_KEY with your actual API key.

Ruby
require 'httparty'
require 'json'

API_KEY = 'YOUR_API_KEY'

def scrape
  response = HTTParty.get(
    "https://api.scrapecreators.com/v1/tiktok/search/top",
    headers: {
      'x-api-key' => API_KEY,
      'Content-Type' => 'application/json'
    },
    query: {
        'query' => 'funny',
      'publish_time' => 'all-time',
      'sort_by' => 'relevance',
      'region' => 'example_value',
      'cursor' => 'example_value'
    }
  )

  puts 'Response:'
  puts JSON.pretty_generate(response.parsed_response)
  response.parsed_response
rescue => e
  puts "Error: #{e.message}"
  nil
end

# Usage
result = scrape

Step 3: Testing Your Code

API Parameters

This endpoint accepts the following parameters:

queryRequired(string)

Keyword to search for

Example: funny

publish_timeOptional(select)

Time Frame TikTok was posted

Example: all-time

sort_byOptional(select)

Sort by

Example: relevance

regionOptional(string)

Note, this doesn't filter the tiktoks only in a specfic region, it puts the proxy there. Use it in case you want to scrape posts only available for some country. Use 2 letter country codes like US, GB, FR, etc

cursorOptional(number)

Cursor to get more videos. Get 'cursor' from previous response.

0

Run Your Code

Execute your script to test the API connection. You should see a JSON response with TikTok tops data.

✅ Success: You should receive a structured JSON response containing the requested data.

Expected Response

Here's an example of the JSON response you'll receive:

Sample Response
{
  "success": true,
  "items": [
    {
      "id": "7528150371680767263",
      "desc": "Last two brain cells at 3 am 💀 (IB: @Marearo) #dance #trend #fun ",
      "content_type": "video",
      "create_time": "2025-07-17T20:28:28.000Z",
      "desc_language": "en",
      "region": "US",
      "is_top": 0,
      "statistics": {
        "aweme_id": "7528150371680767263",
        "collect_count": 101,
        "comment_count": 83,
        "digg_count": 1895,
        "download_count": 3,
        "forward_count": 0,
        "lose_comment_count": 0,
        "lose_count": 0,
        "play_count": 17897,
        "repost_count": 0,
        "share_count": 27,
        "whatsapp_share_count": 1
      },
      "video": {
        "CoverTsp": 11.37871674085026,
        "ai_dynamic_cover": {
          "uri": "tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq",
          "url_list": [
            "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-tiktokx-origin.image?dr=8606&refresh_token=51397adc&x-expires=1752876000&x-signature=RXrltd1boDTaIdiMMiMYHyAli5I%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=dynamic_cover",
            "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-tiktokx-origin.image?dr=8606&refresh_token=11f11f2b&x-expires=1752876000&x-signature=IeFi%2Fxm3eCB0AUQq2YhFyqijf%2Fg%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=dynamic_cover",
            "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-tiktokx-origin.jpeg?dr=8606&refresh_token=8a6d2055&x-expires=1752876000&x-signature=NRqus7CmX9CERlIA3A%2BeU4U2Tpc%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=dynamic_cover"
          ],
          "url_prefix": null
        },
        "ai_dynamic_cover_bak": {
          "uri": "tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq",
          "url_list": [
            "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-tiktokx-origin.image?dr=8606&refresh_token=51397adc&x-expires=1752876000&x-signature=RXrltd1boDTaIdiMMiMYHyAli5I%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=dynamic_cover",
            "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-tiktokx-origin.image?dr=8606&refresh_token=11f11f2b&x-expires=1752876000&x-signature=IeFi%2Fxm3eCB0AUQq2YhFyqijf%2Fg%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=dynamic_cover",
            "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-tiktokx-origin.jpeg?dr=8606&refresh_token=8a6d2055&x-expires=1752876000&x-signature=NRqus7CmX9CERlIA3A%2BeU4U2Tpc%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=dynamic_cover"
          ],
          "url_prefix": null
        },
        "animated_cover": {
          "uri": "tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq",
          "url_list": [
            "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-tiktokx-origin.image?dr=8606&refresh_token=51397adc&x-expires=1752876000&x-signature=RXrltd1boDTaIdiMMiMYHyAli5I%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=dynamic_cover",
            "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-tiktokx-origin.image?dr=8606&refresh_token=11f11f2b&x-expires=1752876000&x-signature=IeFi%2Fxm3eCB0AUQq2YhFyqijf%2Fg%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=dynamic_cover",
            "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-tiktokx-origin.jpeg?dr=8606&refresh_token=8a6d2055&x-expires=1752876000&x-signature=NRqus7CmX9CERlIA3A%2BeU4U2Tpc%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=dynamic_cover"
          ],
          "url_prefix": null
        },
        "big_thumbs": [],
        "bit_rate": [
          {
            "HDR_bit": "",
            "HDR_type": "",
            "bit_rate": 1326185,
            "dub_infos": null,
            "fid_profile_labels": "",
            "fps": 30,
            "gear_name": "adapt_lower_720_1",
            "is_bytevc1": 1,
            "play_addr": {
              "data_size": 2436865,
              "file_cs": "c:0-13885-5eb6",
              "file_hash": "200c46b870633f7a59a6eefe36589e59",
              "height": 1280,
              "uri": "v15044gf0000d1slnk7og65sl3jnp5ig",
              "url_key": "v15044gf0000d1slnk7og65sl3jnp5ig_bytevc1_720p_1326185",
              "url_list": [
                "https://v16m.tiktokcdn-us.com/9818d3bba8692644d9d437438798207d/6879c873/video/tos/useast8/tos-useast8-pve-0068-tx2/owApIIMQqEQgEjkIvKyfCFvebDfDUVQ5LK57cA/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2590&bt=1295&cs=2&ds=3&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=14&rc=NjtmZzw6ZWg4M2Q0M2llaEBpajhxNnY5cm5vNDMzaTczNEBiYTAzMDAvNTMxXjExLjU0YSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
                "https://v19.tiktokcdn-us.com/d7afcdc8450a75af57106618ea5ed5ae/6879c873/video/tos/useast8/tos-useast8-pve-0068-tx2/owApIIMQqEQgEjkIvKyfCFvebDfDUVQ5LK57cA/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2590&bt=1295&cs=2&ds=3&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=14&rc=NjtmZzw6ZWg4M2Q0M2llaEBpajhxNnY5cm5vNDMzaTczNEBiYTAzMDAvNTMxXjExLjU0YSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
                "https://api16-normal-useast5.tiktokv.us/aweme/v1/play/?faid=1233&file_id=7e8b1f4041aa40658e2b37396d3cd8e3&is_play_url=1&item_id=7528150371680767263&line=0&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjVjMGM1ZDM0MWVhMzA3MjAxYThmYzA3ZTU2NmNiZmQz&source=SEARCH&video_id=v15044gf0000d1slnk7og65sl3jnp5ig"
              ],
              "url_prefix": null,
              "width": 720
            },
            "quality_type": 14,
            "video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 247107}, {\\\"time\\\": 2, \\\"offset\\\": 286167}, {\\\"time\\\": 3, \\\"offset\\\": 333920}, {\\\"time\\\": 4, \\\"offset\\\": 494652}, {\\\"time\\\": 5, \\\"offset\\\": 649124}, {\\\"time\\\": 10, \\\"offset\\\": 1627020}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 90.88, \\\"v960\\\": 93.364, \\\"v864\\\": 94.514, \\\"v720\\\": 96.858}, \\\"ori\\\": {\\\"v1080\\\": 78.306, \\\"v960\\\": 81.88, \\\"v864\\\": 84.791, \\\"v720\\\": 90.055}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"0ae394037572ea033285aeadc0ac4a6b\",\"dec_info\":\"\",\"gearvqm\":\"{\\\"v3.0\\\": {\\\"ori\\\": 85.862, \\\"sr20\\\": 92.464}}\"}"
          },
          {
            "HDR_bit": "",
            "HDR_type": "",
            "bit_rate": 1023722,
            "dub_infos": null,
            "fid_profile_labels": "",
            "fps": 30,
            "gear_name": "adapt_540_1",
            "is_bytevc1": 1,
            "play_addr": {
              "data_size": 1881090,
              "file_cs": "c:0-13885-b8f1",
              "file_hash": "359600b323417b06dd532ddf73866027",
              "height": 1024,
              "uri": "v15044gf0000d1slnk7og65sl3jnp5ig",
              "url_key": "v15044gf0000d1slnk7og65sl3jnp5ig_bytevc1_540p_1023722",
              "url_list": [
                "https://v16m.tiktokcdn-us.com/657c39a6745042440456cecef207c9ca/6879c873/video/tos/useast8/tos-useast8-pve-0068-tx2/owdqQMBlV5AWRB8y1EPBkl0bOHMXIA8iEialO/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1998&bt=999&cs=2&ds=6&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=11&rc=PGQ5aGg7OTU6PDllNWk8N0BpajhxNnY5cm5vNDMzaTczNEBiMDA2LTAzNjAxMmEwNi02YSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
                "https://v19.tiktokcdn-us.com/6142eb1f8761261f75377d2bbf8de0ae/6879c873/video/tos/useast8/tos-useast8-pve-0068-tx2/owdqQMBlV5AWRB8y1EPBkl0bOHMXIA8iEialO/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1998&bt=999&cs=2&ds=6&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=11&rc=PGQ5aGg7OTU6PDllNWk8N0BpajhxNnY5cm5vNDMzaTczNEBiMDA2LTAzNjAxMmEwNi02YSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
                "https://api16-normal-useast5.tiktokv.us/aweme/v1/play/?faid=1233&file_id=94099f32db5649379266380e9e363ae9&is_play_url=1&item_id=7528150371680767263&line=0&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjIyM2IzNGNkODkyZDY2YjMwMTRlMDViNWQ3ODg4MDQ2&source=SEARCH&video_id=v15044gf0000d1slnk7og65sl3jnp5ig"
              ],
              "url_prefix": null,
              "width": 576
            },
            "quality_type": 28,
            "video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 164282}, {\\\"time\\\": 2, \\\"offset\\\": 190677}, {\\\"time\\\": 3, \\\"offset\\\": 225069}, {\\\"time\\\": 4, \\\"offset\\\": 342228}, {\\\"time\\\": 5, \\\"offset\\\": 464316}, {\\\"time\\\": 10, \\\"offset\\\": 1257016}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 84.368, \\\"v960\\\": 89.227, \\\"v864\\\": 91.383, \\\"v720\\\": 94.424}, \\\"ori\\\": {\\\"v1080\\\": 70.916, \\\"v960\\\": 75.643, \\\"v864\\\": 79.063, \\\"v720\\\": 84.163}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"12a0943fb20072e391017dc242deb5dc\",\"dec_info\":\"\",\"gearvqm\":\"{\\\"v3.0\\\": {\\\"ori\\\": 79.728, \\\"sr20\\\": 88.484}}\"}"
          },
          {
            "HDR_bit": "",
            "HDR_type": "",
            "bit_rate": 873888,
            "dub_infos": null,
            "fid_profile_labels": "",
            "fps": 30,
            "gear_name": "lower_540_1",
            "is_bytevc1": 1,
            "play_addr": {
              "data_size": 1605770,
              "file_cs": "c:0-13871-66d8",
              "file_hash": "6e09594d2d802f583ba4abea7cf5d05f",
              "height": 1024,
              "uri": "v15044gf0000d1slnk7og65sl3jnp5ig",
              "url_key": "v15044gf0000d1slnk7og65sl3jnp5ig_bytevc1_540p_873888",
              "url_list": [
                "https://v16m.tiktokcdn-us.com/8e438aa1af5d108c62583d6da97f505f/6879c873/video/tos/useast8/tos-useast8-pve-0068-tx2/oMDA8ls9EiqVl8hP5HiAQdIB0ElbiBaRXOwBB/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1706&bt=853&cs=2&ds=6&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=4&rc=ZjMzOjhpNGZkOzg0aGhkM0BpajhxNnY5cm5vNDMzaTczNEBiYjExYzYzNWMxNF8yXzAuYSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
                "https://v19.tiktokcdn-us.com/47bd2a664f4fe0aa3805d2705ed06788/6879c873/video/tos/useast8/tos-useast8-pve-0068-tx2/oMDA8ls9EiqVl8hP5HiAQdIB0ElbiBaRXOwBB/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1706&bt=853&cs=2&ds=6&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=4&rc=ZjMzOjhpNGZkOzg0aGhkM0BpajhxNnY5cm5vNDMzaTczNEBiYjExYzYzNWMxNF8yXzAuYSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
                "https://api16-normal-useast5.tiktokv.us/aweme/v1/play/?faid=1233&file_id=103abe5eb17548fa8c619ff54740e0ec&is_play_url=1&item_id=7528150371680767263&line=0&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLmNjN2E2MDczNDBhN2IzYzZmZjYwMzc1MDA3YTcxYjll&source=SEARCH&video_id=v15044gf0000d1slnk7og65sl3jnp5ig"
              ],
              "url_prefix": null,
              "width": 576
            },
            "quality_type": 24,
            "video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 149729}, {\\\"time\\\": 2, \\\"offset\\\": 187418}, {\\\"time\\\": 3, \\\"offset\\\": 226632}, {\\\"time\\\": 4, \\\"offset\\\": 346798}, {\\\"time\\\": 5, \\\"offset\\\": 449023}, {\\\"time\\\": 10, \\\"offset\\\": 1074933}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 80.387, \\\"v960\\\": 84.691, \\\"v864\\\": 86.754, \\\"v720\\\": 91.09}, \\\"ori\\\": {\\\"v1080\\\": 66.313, \\\"v960\\\": 70.973, \\\"v864\\\": 74.613, \\\"v720\\\": 81.273}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"910baea0ae0c0aa4f683316c9ced388e\",\"dec_info\":\"\",\"gearvqm\":\"{\\\"v3.0\\\": {\\\"ori\\\": 74.675, \\\"sr20\\\": 83.43}}\"}"
          },
          {
            "HDR_bit": "",
            "HDR_type": "",
            "bit_rate": 541841,
            "dub_infos": null,
            "fid_profile_labels": "",
            "fps": 30,
            "gear_name": "lowest_540_1",
            "is_bytevc1": 1,
            "play_addr": {
              "data_size": 995634,
              "file_cs": "c:0-13887-85d5",
              "file_hash": "f352bbfed168524086413ca9a882c124",
              "height": 1024,
              "uri": "v15044gf0000d1slnk7og65sl3jnp5ig",
              "url_key": "v15044gf0000d1slnk7og65sl3jnp5ig_bytevc1_540p_541841",
              "url_list": [
                "https://v16m.tiktokcdn-us.com/4826a82d168624373e5f915977eab7c5/6879c873/video/tos/useast8/tos-useast8-ve-0068c002-tx2/og3yhWA5eAgfheT5eGGh5DFUvIQULRmyoWYQ3y/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1058&bt=529&cs=2&ds=6&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=5&rc=M2Q5Zzs4OGgzNGU4OmU1M0BpajhxNnY5cm5vNDMzaTczNEA0MTZjLmBhNjYxXzYyNjA2YSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
                "https://v19.tiktokcdn-us.com/cbbac0ae86a846c9a408c13a16ff2aa3/6879c873/video/tos/useast8/tos-useast8-ve-0068c002-tx2/og3yhWA5eAgfheT5eGGh5DFUvIQULRmyoWYQ3y/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1058&bt=529&cs=2&ds=6&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=5&rc=M2Q5Zzs4OGgzNGU4OmU1M0BpajhxNnY5cm5vNDMzaTczNEA0MTZjLmBhNjYxXzYyNjA2YSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
                "https://api16-normal-useast5.tiktokv.us/aweme/v1/play/?faid=1233&file_id=90329b5795bb41909ed5c518fd964a70&is_play_url=1&item_id=7528150371680767263&line=0&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLmE1YmRhYTdhNTRiZjFiZjBhMTRkYmE5ZGRhMDhhNzA1&source=SEARCH&video_id=v15044gf0000d1slnk7og65sl3jnp5ig"
              ],
              "url_prefix": null,
              "width": 576
            },
            "quality_type": 25,
            "video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 102725}, {\\\"time\\\": 2, \\\"offset\\\": 123912}, {\\\"time\\\": 3, \\\"offset\\\": 147165}, {\\\"time\\\": 4, \\\"offset\\\": 216826}, {\\\"time\\\": 5, \\\"offset\\\": 290895}, {\\\"time\\\": 10, \\\"offset\\\": 686573}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 70.565, \\\"v960\\\": 75.222, \\\"v864\\\": 77.976, \\\"v720\\\": 83.12}, \\\"ori\\\": {\\\"v1080\\\": 56.775, \\\"v960\\\": 62.048, \\\"v864\\\": 65.828, \\\"v720\\\": 73.457}}}\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"c49b38c1a20ed0c0f4dd45235a936391\",\"dec_info\":\"\",\"gearvqm\":\"\"}"
          }
        ],
        "bit_rate_audio": [],
        "cdn_url_expired": 0,
        "cla_info": {
          "caption_infos": null,
          "captions_type": 0,
          "creator_edited_caption_id": 0,
          "enable_auto_caption": 0,
          "has_original_audio": 0,
          "hide_original_caption": false,
          "no_caption_reason": 3,
          "vertical_positions": null
        },
        "cover": {
          "height": 720,
          "uri": "tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq",
          "url_list": [
            "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-x7g4mazu7z-crop-80-heic:400:600.heic?biz_tag=musically_general.video_cover&dr=9616&ftpl=1&idc=useast5&ps=13740610&refresh_token=08d59ec7&shcp=c1333099&shp=0e6dc556&t=4d5b0474&x-expires=1752811200&x-signature=wTStrJ1l78KOyytJKq%2Bi63aJeG8%3D",
            "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-x7g4mazu7z-crop-80-heic:400:600.heic?biz_tag=musically_general.video_cover&dr=9616&ftpl=1&idc=useast5&ps=13740610&refresh_token=31e9f6c5&shcp=c1333099&shp=0e6dc556&t=4d5b0474&x-expires=1752811200&x-signature=h25zc%2FIq1zmKv0mTMD9j1K6%2FS74%3D",
            "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-x7g4mazu7z-crop-80-heic:400:600.jpeg?biz_tag=musically_general.video_cover&dr=9616&ftpl=1&idc=useast5&ps=13740610&refresh_token=bfef4ef2&shcp=c1333099&shp=0e6dc556&t=4d5b0474&x-expires=1752811200&x-signature=1uBkhBMikYNETi1FXb7wPqGeG6A%3D"
          ],
          "url_prefix": null,
          "width": 720
        },
        "cover_is_custom": true,
        "did_profile_labels": "",
        "download_addr": {
          "data_size": 3594950,
          "file_cs": "c:0-13685-49a8",
          "height": 720,
          "uri": "v15044gf0000d1slnk7og65sl3jnp5ig",
          "url_list": [
            "https://v16m.tiktokcdn-us.com/b21ab8dfc97f204c396631e2e9ddbb87/6879c873/video/tos/useast8/tos-useast8-ve-0068c002-tx2/oohNIoI5AeyGAg3ehNRn5cLfRyQlUWecFWAUGt/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3820&bt=1910&cs=0&ds=3&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=0&rc=ZTxnZDo1Z2g2ZWg3M2RoZEBpajhxNnY5cm5vNDMzaTczNEBiM2A0NjQ1Ni8xLjQ0LTIvYSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
            "https://v19.tiktokcdn-us.com/637781f2541bda3f3ea52fd4e48b6247/6879c873/video/tos/useast8/tos-useast8-ve-0068c002-tx2/oohNIoI5AeyGAg3ehNRn5cLfRyQlUWecFWAUGt/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3820&bt=1910&cs=0&ds=3&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=0&rc=ZTxnZDo1Z2g2ZWg3M2RoZEBpajhxNnY5cm5vNDMzaTczNEBiM2A0NjQ1Ni8xLjQ0LTIvYSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
            "https://api16-normal-useast5.tiktokv.us/aweme/v1/play/?video_id=v15044gf0000d1slnk7og65sl3jnp5ig&line=0&watermark=1&logo_name=tiktok_m&source=SEARCH&file_id=2a5e0a70741e4b239e8d72977acd69eb&item_id=7528150371680767263&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjRhNTUwYzQ1NzQyYzUzZmM0NWM2ZGUzNmJlZTYxYWNm&shp=d05b14bd&shcp=-"
          ],
          "url_prefix": null,
          "width": 720
        },
        "download_no_watermark_addr": {
          "data_size": 3619839,
          "file_cs": "c:0-13685-49a8",
          "file_hash": "1859457b13c3c699b1a181bf43949331",
          "height": 1024,
          "uri": "v15044gf0000d1slnk7og65sl3jnp5ig",
          "url_key": "v15044gf0000d1slnk7og65sl3jnp5ig_h264_540p_1969980",
          "url_list": [
            "https://v16m.tiktokcdn-us.com/d13761ce93fdac91545c2f5afef392fd/6879c873/video/tos/useast8/tos-useast8-ve-0068c001-tx2/oYXH5AWWallOl8VPDcdAR5OSE0qbiPBIBQ8iE/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3846&bt=1923&cs=0&ds=6&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=0&rc=NTk3ZTY2ODVlZjo0Zmc7OkBpajhxNnY5cm5vNDMzaTczNEAtNTAxNDRfXjUxL182LTU2YSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
            "https://v19.tiktokcdn-us.com/c171dbdafe818e0fd3662a4be37ad635/6879c873/video/tos/useast8/tos-useast8-ve-0068c001-tx2/oYXH5AWWallOl8VPDcdAR5OSE0qbiPBIBQ8iE/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3846&bt=1923&cs=0&ds=6&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=0&rc=NTk3ZTY2ODVlZjo0Zmc7OkBpajhxNnY5cm5vNDMzaTczNEAtNTAxNDRfXjUxL182LTU2YSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
            "https://api16-normal-useast5.tiktokv.us/aweme/v1/play/?faid=1233&file_id=97880d9cb1274c8ba2b573734b348602&is_play_url=1&item_id=7528150371680767263&line=0&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjI4MzNkNzNjYzg3M2IzNzIyNjk5YTU0Y2EyMmFmYjU3&source=SEARCH&video_id=v15044gf0000d1slnk7og65sl3jnp5ig"
          ],
          "url_prefix": null,
          "width": 576
        },
        "duration": 14700,
        "dynamic_cover": {
          "height": 720,
          "uri": "tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq",
          "url_list": [
            "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-tiktokx-origin.image?dr=8606&refresh_token=11f11f2b&x-expires=1752876000&x-signature=IeFi%2Fxm3eCB0AUQq2YhFyqijf%2Fg%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=dynamic_cover",
            "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-tiktokx-origin.image?dr=8606&refresh_token=51397adc&x-expires=1752876000&x-signature=RXrltd1boDTaIdiMMiMYHyAli5I%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=dynamic_cover",
            "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogBjDEAfE9QAhZIOIE5AtqFAveLqXIfViuAqzq~tplv-tiktokx-origin.jpeg?dr=8606&refresh_token=31622a04&x-expires=1752876000&x-signature=KjubJPMHPf%2FYLLHRk5y6jEvVtwc%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=dynamic_cover"
          ],
          "url_prefix": null,
          "width": 720
        },
        "has_watermark": true,
        "height": 1024,
        "is_bytevc1": 0,
        "is_callback": true,
        "meta": "{\"LoudnessRange\":\"1.5\",\"LoudnessRangeEnd\":\"-12.1\",\"LoudnessRangeStart\":\"-13.6\",\"MaximumMomentaryLoudness\":\"-11.3\",\"MaximumShortTermLoudness\":\"-12\",\"Version\":\"2\",\"VolumeInfoJson\":\"{\\\"MaximumMomentaryLoudness\\\":-11.3,\\\"MaximumShortTermLoudness\\\":-12,\\\"Peak\\\":0.5821,\\\"Loudness\\\":-12.6,\\\"LoudnessRange\\\":1.5,\\\"LoudnessRangeEnd\\\":-12.1,\\\"LoudnessRangeStart\\\":-13.6,\\\"Metrics\\\":{\\\"AEDInfo\\\":{\\\"MusicRatio\\\":1,\\\"SingingRatio\\\":0.79,\\\"SpeechRatio\\\":0},\\\"Cutoff\\\":{\\\"Spkr150G\\\":2.65,\\\"Spkr200G\\\":2.94,\\\"FCenL\\\":2809.08,\\\"FCenR\\\":2809.74,\\\"Spkr100G\\\":2.04},\\\"Loudness\\\":{\\\"Integrated\\\":-12.622},\\\"Phase\\\":{\\\"RMSDownmixDiff\\\":-0.077},\\\"RMSStats\\\":{\\\"Peak\\\":-4.719,\\\"RTotal\\\":-12.545,\\\"LRDiff\\\":-0.016,\\\"LTotal\\\":-12.561},\\\"Version\\\":\\\"1.4.2\\\"},\\\"Version\\\":2}\",\"bright_ratio_mean\":\"0.0247\",\"brightness_mean\":\"160.6235\",\"diff_overexposure_ratio\":\"0.0058\",\"flight_id\":\"\",\"loudness\":\"-12.6\",\"overexposure_ratio_mean\":\"0.0235\",\"peak\":\"0.5821\",\"play_time_prob_dist\":\"[800,0.8293,3081.3322]\",\"sr_score\":\"1.000\",\"std_brightness\":\"2.969\",\"vq_score\":\"0\"}",
        "misc_download_addrs": "{\"suffix_scene\":{\"uri\":\"v15044gf0000d1slnk7og65sl3jnp5ig\",\"url_list\":[\"https://v16m.tiktokcdn-us.com/50977d4846143023daa91919d40b211d/6879c873/video/tos/useast8/tos-useast8-pve-0068-tx2/ocAVPlqERFIiBbl8Eco0HsaliDb85OA1BIdQB/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3230&bt=1615&cs=0&ds=3&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=0&rc=N2hpNWQ2aThmZztnOjxkPEBpajhxNnY5cm5vNDMzaTczNEBeYDIyMTRjXl4xYzMwMDVjYSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000\",\"https://v19.tiktokcdn-us.com/9a47bb579caa9de23a9a6acb2238516f/6879c873/video/tos/useast8/tos-useast8-pve-0068-tx2/ocAVPlqERFIiBbl8Eco0HsaliDb85OA1BIdQB/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3230&bt=1615&cs=0&ds=3&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=0&rc=N2hpNWQ2aThmZztnOjxkPEBpajhxNnY5cm5vNDMzaTczNEBeYDIyMTRjXl4xYzMwMDVjYSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000\",\"https://api16-normal-useast5.tiktokv.us/aweme/v1/play/?video_id=v15044gf0000d1slnk7og65sl3jnp5ig&line=0&watermark=1&logo_name=tiktok_end_sonic&source=SEARCH&file_id=f98a39376df84daca5ff734a525fcea4&item_id=7528150371680767263&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjdiZTg4N2VkMDIyNjUwZmMzMWYwOTEwM2RiNzcxNWM5&shp=d05b14bd&shcp=-\"],\"width\":720,\"height\":720,\"data_size\":3867261,\"file_cs\":\"c:0-13685-49a8\",\"url_prefix\":null}}",
        "need_set_token": false,
        "origin_cover": {
          "height": 720,
          "uri": "tos-useast8-p-0068-tx2/oUOAX8aqy5l01iiPVb1CH8OBlRd0E1IjBIBAl",
          "url_list": [
            "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oUOAX8aqy5l01iiPVb1CH8OBlRd0E1IjBIBAl~tplv-dmt-adapt-360p.heic?dr=8597&refresh_token=f5550b84&x-expires=1752876000&x-signature=gJ4wcqFj6hXrj70sSczyjrZU7r4%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=feed_cover",
            "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oUOAX8aqy5l01iiPVb1CH8OBlRd0E1IjBIBAl~tplv-dmt-adapt-360p.heic?dr=8597&refresh_token=adcdcd06&x-expires=1752876000&x-signature=g3VPC5Q9LtEpHGqUG%2F9pGDI351Q%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=feed_cover",
            "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oUOAX8aqy5l01iiPVb1CH8OBlRd0E1IjBIBAl~tplv-dmt-adapt-360p.jpeg?dr=8597&refresh_token=ece32a17&x-expires=1752876000&x-signature=iqeOZlVVv8RiqiYuULQYlPIDCEM%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=0e6dc556&idc=useast5&biz_tag=tt_video&s=SEARCH&sc=feed_cover"
          ],
          "url_prefix": null,
          "width": 720
        },
        "play_addr": {
          "data_size": 3619839,
          "file_cs": "c:0-13685-49a8",
          "file_hash": "1859457b13c3c699b1a181bf43949331",
          "height": 1024,
          "uri": "v15044gf0000d1slnk7og65sl3jnp5ig",
          "url_key": "v15044gf0000d1slnk7og65sl3jnp5ig_h264_540p_1969980",
          "url_list": [
            "https://v16m.tiktokcdn-us.com/d13761ce93fdac91545c2f5afef392fd/6879c873/video/tos/useast8/tos-useast8-ve-0068c001-tx2/oYXH5AWWallOl8VPDcdAR5OSE0qbiPBIBQ8iE/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3846&bt=1923&cs=0&ds=6&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=0&rc=NTk3ZTY2ODVlZjo0Zmc7OkBpajhxNnY5cm5vNDMzaTczNEAtNTAxNDRfXjUxL182LTU2YSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
            "https://v19.tiktokcdn-us.com/c171dbdafe818e0fd3662a4be37ad635/6879c873/video/tos/useast8/tos-useast8-ve-0068c001-tx2/oYXH5AWWallOl8VPDcdAR5OSE0qbiPBIBQ8iE/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3846&bt=1923&cs=0&ds=6&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=0&rc=NTk3ZTY2ODVlZjo0Zmc7OkBpajhxNnY5cm5vNDMzaTczNEAtNTAxNDRfXjUxL182LTU2YSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
            "https://api16-normal-useast5.tiktokv.us/aweme/v1/play/?faid=1233&file_id=97880d9cb1274c8ba2b573734b348602&is_play_url=1&item_id=7528150371680767263&line=0&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjI4MzNkNzNjYzg3M2IzNzIyNjk5YTU0Y2EyMmFmYjU3&source=SEARCH&video_id=v15044gf0000d1slnk7og65sl3jnp5ig"
          ],
          "url_prefix": null,
          "width": 576
        },
        "play_addr_bytevc1": {
          "data_size": 1881090,
          "file_cs": "c:0-13885-b8f1",
          "file_hash": "359600b323417b06dd532ddf73866027",
          "height": 1024,
          "uri": "v15044gf0000d1slnk7og65sl3jnp5ig",
          "url_key": "v15044gf0000d1slnk7og65sl3jnp5ig_bytevc1_540p_1023722",
          "url_list": [
            "https://v16m.tiktokcdn-us.com/657c39a6745042440456cecef207c9ca/6879c873/video/tos/useast8/tos-useast8-pve-0068-tx2/owdqQMBlV5AWRB8y1EPBkl0bOHMXIA8iEialO/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1998&bt=999&cs=2&ds=6&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=11&rc=PGQ5aGg7OTU6PDllNWk8N0BpajhxNnY5cm5vNDMzaTczNEBiMDA2LTAzNjAxMmEwNi02YSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
            "https://v19.tiktokcdn-us.com/6142eb1f8761261f75377d2bbf8de0ae/6879c873/video/tos/useast8/tos-useast8-pve-0068-tx2/owdqQMBlV5AWRB8y1EPBkl0bOHMXIA8iEialO/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1998&bt=999&cs=2&ds=6&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=11&rc=PGQ5aGg7OTU6PDllNWk8N0BpajhxNnY5cm5vNDMzaTczNEBiMDA2LTAzNjAxMmEwNi02YSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
            "https://api16-normal-useast5.tiktokv.us/aweme/v1/play/?faid=1233&file_id=94099f32db5649379266380e9e363ae9&is_play_url=1&item_id=7528150371680767263&line=0&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjIyM2IzNGNkODkyZDY2YjMwMTRlMDViNWQ3ODg4MDQ2&source=SEARCH&video_id=v15044gf0000d1slnk7og65sl3jnp5ig"
          ],
          "url_prefix": null,
          "width": 576
        },
        "play_addr_h264": {
          "data_size": 3619839,
          "file_cs": "c:0-13685-49a8",
          "file_hash": "1859457b13c3c699b1a181bf43949331",
          "height": 1024,
          "uri": "v15044gf0000d1slnk7og65sl3jnp5ig",
          "url_key": "v15044gf0000d1slnk7og65sl3jnp5ig_h264_540p_1969980",
          "url_list": [
            "https://v16m.tiktokcdn-us.com/d13761ce93fdac91545c2f5afef392fd/6879c873/video/tos/useast8/tos-useast8-ve-0068c001-tx2/oYXH5AWWallOl8VPDcdAR5OSE0qbiPBIBQ8iE/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3846&bt=1923&cs=0&ds=6&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=0&rc=NTk3ZTY2ODVlZjo0Zmc7OkBpajhxNnY5cm5vNDMzaTczNEAtNTAxNDRfXjUxL182LTU2YSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
            "https://v19.tiktokcdn-us.com/c171dbdafe818e0fd3662a4be37ad635/6879c873/video/tos/useast8/tos-useast8-ve-0068c001-tx2/oYXH5AWWallOl8VPDcdAR5OSE0qbiPBIBQ8iE/?a=1233&bti=NEBzbmQxZmR2bndsQGo6OjZALnAjYG1lb2IrbGhxYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=3846&bt=1923&cs=0&ds=6&ft=gKfIn8QLodzR12Nvc8.pWIxR5YaEZQ_45SY&mime_type=video_mp4&qs=0&rc=NTk3ZTY2ODVlZjo0Zmc7OkBpajhxNnY5cm5vNDMzaTczNEAtNTAxNDRfXjUxL182LTU2YSNmbWdpMmQ0a3BhLS1kMTJzcw%3D%3D&vvpl=1&l=2025071722070196628CAF0563641DD450&btag=e000b8000",
            "https://api16-normal-useast5.tiktokv.us/aweme/v1/play/?faid=1233&file_id=97880d9cb1274c8ba2b573734b348602&is_play_url=1&item_id=7528150371680767263&line=0&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjI4MzNkNzNjYzg3M2IzNzIyNjk5YTU0Y2EyMmFmYjU3&source=SEARCH&video_id=v15044gf0000d1slnk7og65sl3jnp5ig"
          ],
          "url_prefix": null,
          "width": 576
        },
        "ratio": "540p",
        "source_HDR_type": 0,
        "tags": null,
        "vid_profile_labels": "{\"tier3\":\"10080\"}",
        "width": 576
      },
      "author": {
        "accept_private_policy": false,
        "account_labels": null,
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "authority_status": 0,
        "avatar_168x168": {
          "height": 720,
          "uri": "tos-useast5-avt-0068-tx/7321410560359137323",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=8833&idc=useast5&ps=87d6e48a&refresh_token=95be35e7&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=CLeJNS%2FsBKrrLNXJ40JL4XM2FTQ%3D",
            "https://p19-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=8833&idc=useast5&ps=87d6e48a&refresh_token=bf5109f4&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=t5BLV7GS8Zzdz8uwvGnUG%2B2rWh0%3D",
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:168:168:q70.jpeg?dr=8833&idc=useast5&ps=87d6e48a&refresh_token=c440920a&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=5OEq%2FKEc47b%2BLg0nuWiIIP99CKE%3D"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_300x300": {
          "height": 720,
          "uri": "tos-useast5-avt-0068-tx/7321410560359137323",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=8834&idc=useast5&ps=87d6e48a&refresh_token=03ccc7be&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=daKH6b1z%2FN24%2F2nhwYO3cAaY2mE%3D",
            "https://p19-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=8834&idc=useast5&ps=87d6e48a&refresh_token=ad3939bf&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=WLCeyrqT%2BK%2BuxrY76UF5cPPkXJY%3D",
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=8834&idc=useast5&ps=87d6e48a&refresh_token=e94ec98c&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=8N8QX7%2BwDhRFVO%2F3u4gta5am%2FrY%3D"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_larger": {
          "height": 720,
          "uri": "tos-useast5-avt-0068-tx/7321410560359137323",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=8837&idc=useast5&ps=87d6e48a&refresh_token=cacebc3e&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=RxWl6pnh8jId4kte%2Fxcy2e1ky5o%3D",
            "https://p19-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=8837&idc=useast5&ps=87d6e48a&refresh_token=c1155bbc&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=QMZTNj2qOqgvHjaPrJ%2FmF%2BDdcaA%3D",
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=8837&idc=useast5&ps=87d6e48a&refresh_token=c27dcb0a&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=371lcfAgCGpSBIF6zxfFYAO%2BywQ%3D"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_medium": {
          "height": 720,
          "uri": "tos-useast5-avt-0068-tx/7321410560359137323",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=8836&idc=useast5&ps=87d6e48a&refresh_token=07bb228c&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=AA64tedKFOO2Pd5wSmQ6n68%2Bkec%3D",
            "https://p19-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=8836&idc=useast5&ps=87d6e48a&refresh_token=046b6ba6&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=pv%2Fjd2T7kN139rhoeshMlwhshXo%3D",
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:720:720:q70.jpeg?dr=8836&idc=useast5&ps=87d6e48a&refresh_token=775fb8a2&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=gkRY4NAJegIM8KjBSEKX9Ve3Qi0%3D"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_thumb": {
          "height": 720,
          "uri": "tos-useast5-avt-0068-tx/7321410560359137323",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:100:100:q70.heic?biz_tag=musically_general.video_user_cover&dr=8835&idc=useast5&ps=87d6e48a&refresh_token=5abcd84d&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=yRmhLahQVnLEkpxd6EQ6EAqIJIs%3D",
            "https://p19-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:100:100:q70.heic?biz_tag=musically_general.video_user_cover&dr=8835&idc=useast5&ps=87d6e48a&refresh_token=7a647beb&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=SXTHQTwgn03vkmhBcBz1S1plJxw%3D",
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7321410560359137323~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?biz_tag=musically_general.video_user_cover&dr=8835&idc=useast5&ps=87d6e48a&refresh_token=ee7e8445&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1752876000&x-signature=a3LUnp%2BncWH0Ckp9nt57pxHvIEw%3D"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_uri": "tos-useast5-avt-0068-tx/7321410560359137323",
        "aweme_count": 0,
        "bold_fields": null,
        "can_message_follow_status_list": null,
        "can_set_geofencing": null,
        "cha_list": null,
        "comment_filter_status": 0,
        "comment_setting": 0,
        "commerce_user_level": 0,
        "cover_url": null,
        "custom_verify": "Verified account",
        "cv_level": "",
        "download_prompt_ts": 1705012451,
        "enabled_filter_all_comments": false,
        "enterprise_verify_reason": "",
        "events": null,
        "fake_data_info": {},
        "fb_expire_time": 0,
        "follow_status": 0,
        "follower_count": 9446848,
        "follower_status": 0,
        "followers_detail": null,
        "following_count": 860,
        "friends_status": 0,
        "geofencing": null,
        "hide_search": false,
        "homepage_bottom_toast": null,
        "ins_id": "",
        "is_ad_fake": false,
        "is_block": false,
        "is_discipline_member": false,
        "is_mute": 0,
        "is_mute_lives": 0,
        "is_mute_non_story_post": 0,
        "is_mute_story": 0,
        "is_star": false,
        "item_list": null,
        "live_agreement": 0,
        "live_commerce": false,
        "live_verify": 0,
        "mention_status": 1,
        "mutual_relation_avatars": null,
        "name_field": "nickname",
        "need_points": null,
        "need_recommend": 0,
        "nickname": "Nick Kosir",
        "platform_sync_info": null,
        "prevent_download": false,
        "relative_users": null,
        "reply_with_video_flag": 4,
        "room_id": 0,
        "search_highlight": null,
        "search_user_desc": "officialnickkosir",
        "search_user_name": "Nick Kosir",
        "sec_uid": "MS4wLjABAAAAyxgSubv-AgwPhtf7Xam7IFC4QhOr_7bwnCg-ASCU8C1Ry74fq6gMbG1-CcOe4EU9",
        "secret": 0,
        "shield_comment_notice": 0,
        "shield_digg_notice": 0,
        "shield_edit_field_info": null,
        "shield_follow_notice": 0,
        "short_id": "0",
        "show_image_bubble": false,
        "special_account": {
          "special_account_list": null
        },
        "special_lock": 1,
        "status": 1,
        "stitch_setting": 0,
        "total_favorited": 0,
        "type_label": null,
        "uid": "6699211557223826437",
        "unique_id": "officialnickkosir",
        "user_canceled": false,
        "user_mode": 1,
        "user_period": 0,
        "user_profile_guide": null,
        "user_rate": 1,
        "user_spark_info": {},
        "user_tags": null,
        "verification_type": 0,
        "verify_info": "",
        "video_icon": {
          "height": 720,
          "uri": "",
          "url_list": [],
          "url_prefix": null,
          "width": 720
        },
        "white_cover_url": null,
        "with_commerce_entry": false,
        "with_shop_entry": false
      },
      "is_eligible_for_commission": false,
      "is_ad": false,
      "url": "https://www.tiktok.com/@officialnickkosir/video/7528150371680767263"
    }
  ],
  "cursor": 30
}

Verify Response Structure

Check that your response includes the expected fields:

  • ✓success(boolean)
  • ✓items(object)
  • ✓cursor(number)

Best Practices

1

Error Handling

Implement comprehensive error handling and retry logic for failed requests. Log errors properly for debugging.

2

Caching

Cache responses when possible to reduce API calls and improve performance. Consider data freshness requirements.

3

Security

Never expose your API key in client-side code. Use environment variables and secure key management practices.

Performance Tips

Batch Requests

When scraping multiple tops, consider batching requests to maximize throughput while staying within rate limits.

Async Processing

Use asynchronous processing in Ruby to handle multiple requests concurrently and improve overall performance.

Common Use Cases

Market Research

Analyze TikTok tops to understand market trends, competitor analysis, and audience insights.

Content Analytics

Track performance metrics, engagement rates, and content trends across TikTok tops.

Lead Generation

Identify potential customers and business opportunities throughTikTok data analysis.

Troubleshooting

Common Errors

401 Unauthorized

Check your API key is correct and properly formatted in the x-api-key header.

402 Payment Required

You ran out of credits and need to buy more.

404 Not Found

The resource might not exist or be private.

500 Server Error

Temporary server issue. Implement retry logic with exponential backoff.

Frequently Asked Questions

How much does it cost to scrape TikTok tops?

ScrapeCreators offers 100 free API calls to get started. After that, pricing starts at $10 for 5k requests with volume discounts available.

Is it legal to scrape TikTok data?

Scraping publicly available data is fair game, and we only collect public data. So anything that you can see in an incognito browser is what we collect.

How fast can I scrape TikTok tops?

There is no rate limit! So you can scrape as fast as you want!

What data format does the API return?

All API responses are returned in JSON format, making it easy to integrate with any programming language or application.

Can I use this with other Ruby frameworks?

Yes! This tutorial focuses on core Ruby HTTP concepts that work with any framework. The API calls remain the same regardless of your specific Ruby setup.

How do I handle large datasets?

For large datasets, implement pagination, use streaming responses where available, and consider storing data in a database for efficient querying.

Related Tutorials

All Tutorials

Browse all available scraping tutorials for different platforms and languages.

Free Tools

Try our free online tools to test scraping without writing any code.

Ready to Start Scraping?

Get started with 100 free API calls. No credit card required.

Start Building ⚡️ View Documentation