> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riona.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Trending Videos

> Get TikTok Trending Videos

<ResponseExample>
  ```json 200 theme={null}
  {
    "status": {
      "code": 200,
      "message": "OK"
    },
    "videos": [
      {
        "title": "Find what you love and try it on with Google. See how clothes and trends look on you before you buy. #GoogleShopping #ShoppingTryOn ",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/oECB8P7CIIMAuq5f3aEAmjB0bSOiii0SAAV9XQ~tplv-noop.image?t=9276707c&x-expires=1755869742&x-signature=6tSmEQMbfLImeyWRwmpNupVj%2B8A%3D",
        "duration": 29,
        "id": "7530685814150384927",
        "item_id": "7530685814150384927",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7530685814150384927",
        "region": "United States"
      },
      {
        "title": "Get outside your comfort phone | 8.20.25  Learn more and sign up for #MadeByGoogle updates: GoogleStore.com",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/oIbMtlpAADEBBBRjiiYAvIiyVaiTQIJgE2NAP~tplv-noop.image?t=9276707c&x-expires=1755869743&x-signature=L4OwpWm8k%2BDJzydzkBB6D4Z6tfY%3D",
        "duration": 30,
        "id": "7534760881968647455",
        "item_id": "7534760881968647455",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7534760881968647455",
        "region": "United States"
      },
      {
        "title": "Join @MrBeast, @TikTok and @WaterAid💧to raise money for #teamwater and bring clean water to over 2 million people for decades! 💧 Add Mr. Beast’s #teamwater fundraiser sticker to your videos to join this global movement ❤️",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/ok0yQ0kjnIRdocGzHBALEIsfQe3QRFICeK6IhA~tplv-noop.image?t=9276707c&x-expires=1755869748&x-signature=jFFrSJEA%2BagibGc1kUSafIAPceA%3D",
        "duration": 35,
        "id": "7534785174203125006",
        "item_id": "7534785174203125006",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7534785174203125006",
        "region": "United States"
      },
      {
        "title": "8.20.25 Ask more of your phone.   Learn more and sign up for #MadeByGoogle updates at GoogleStore.com",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/ocfo3HRkEaDkDmfED9FoRIoWESzJQABp3hAV2A~tplv-noop.image?t=9276707c&x-expires=1755869728&x-signature=L1ux14utWEuVPnc1LCGo6YmkZhw%3D",
        "duration": 15,
        "id": "7535501460688178462",
        "item_id": "7535501460688178462",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7535501460688178462",
        "region": "United States"
      },
      {
        "title": "Mix up your morning routine with this all-in-one mug ☕😋 #SHEIN #SHEINForAll #fashion #saveinstyle #fyp #inspiration",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-85c255/ogIkBnowuBcXSQBqf0IEjFEBFwDbYwC4gfhkWJ~tplv-noop.image?t=9276707c&x-expires=1755869736&x-signature=iKfdKiM%2B3m0DfT81SM9cBjdGfBo%3D",
        "duration": 23,
        "id": "7476469501568093445",
        "item_id": "7476469501568093445",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7476469501568093445",
        "region": "United States"
      },
      {
        "title": "It still feels so unreal! 🤯 #dropshipping #ecommerce #motivation #mindset #millionairemindset #inspiration #entrepreneur",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-85c255c799-us/oMfJa8JUpzOFEwiQJOYi8YKBANlHhIANJ5pCBB~tplv-noop.image?t=9276707c&x-expires=1755869721&x-signature=ZM6CZlznhWoUE%2BklmK3wmSZd7QM%3D",
        "duration": 8,
        "id": "7425631540178160939",
        "item_id": "7425631540178160939",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7425631540178160939",
        "region": "United States"
      },
      {
        "title": "who knows HARD Summer better? our brain or Google Gemini? @SamsungUS 🤖🧠 #GalaxyZFold7 #GalaxyZFlip7",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/ocG7fHZwiIOIFMifFMLIA5GfRPAGcvLgQ8eQI9~tplv-noop.image?t=9276707c&x-expires=1755869744&x-signature=2IAzqT23dYJCCKzIL9%2BjWKz2pWc%3D",
        "duration": 31,
        "id": "7534513231109328142",
        "item_id": "7534513231109328142",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7534513231109328142",
        "region": "United States"
      },
      {
        "title": "Bigger size, bigger scent! Gain Super Flings keep your laundry smelling amazing",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/ooB252PlBJkJ0iACUQ6AAfqXiPIiMITAIMJ5IG~tplv-noop.image?t=9276707c&x-expires=1755869719&x-signature=223R3k5UreZ24QykeDMqinw6XbA%3D",
        "duration": 6,
        "id": "7528104691603934494",
        "item_id": "7528104691603934494",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7528104691603934494",
        "region": "United States"
      },
      {
        "title": "#EggoPartner Back to school means we need a delicious breakfast. @Eggo waffles are our family's favorite and are always at a great price 🤩🧇🧇",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/o0QGhfHTg1d7RFoYryKOjsQAIzIkfllQeAeLG2~tplv-noop.image?t=9276707c&x-expires=1755869742&x-signature=MORlRfFsV5AgLja4Xhv2dO5bJss%3D",
        "duration": 29,
        "id": "7529976947393219895",
        "item_id": "7529976947393219895",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7529976947393219895",
        "region": "United States"
      },
      {
        "title": "Just checked the home security cam and… I think we’ve got guest performers out back! @Ring #bunny #ringdoorbell #ring #bunnies #trampoline ",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/oQKhSEoIDLD9YBkfgEfJAaAP1FkrToDEyluRVF~tplv-noop.image?t=9276707c&x-expires=1755869721&x-signature=gKSjAzpNilCWhCxEd7dTtC%2BQHcI%3D",
        "duration": 8,
        "id": "7531584773500751118",
        "item_id": "7531584773500751118",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7531584773500751118",
        "region": "United States"
      },
      {
        "title": "for 📣ONE WEEKEND ONLY📣 #KPopDemonHunters will be screening in select theaters 8.23 & 8.24",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/oMftolNiIoF3IgEVjgoFBEvDBZLfnIRcyqSADD~tplv-noop.image?t=9276707c&x-expires=1755869741&x-signature=yaGmwTAm4ZCaM0%2FouvedomUPQ0M%3D",
        "duration": 28,
        "id": "7538054464415059214",
        "item_id": "7538054464415059214",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7538054464415059214",
        "region": "United States"
      },
      {
        "title": "this motorola razr ultra just turned into the hottest runway cam at Lolla 🎥💅 @Motorola US #razr #MakeItIconic",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/oIXnMA5aDqCaqIIRyGLeICAufHwTx8EfjHGRIR~tplv-noop.image?t=9276707c&x-expires=1755869730&x-signature=yiOeyoJ66VR%2FZqxq2sZz%2F3XGLsU%3D",
        "duration": 17,
        "id": "7533429680662138142",
        "item_id": "7533429680662138142",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7533429680662138142",
        "region": "United States"
      },
      {
        "title": "The REAL travel violation is calling the violation travel.",
        "country_code": "US",
        "cover": "https://p16-vod-sign-useast2a.tiktokcdn-eu.com/tos-useast2a-p-0037-euttp/oU4IQEjER70IoAwf3YfdF7Cr8oSDEBFwmugDhb~tplv-noop.image?t=9276707c&x-expires=1755869751&x-signature=J8KeL11YIeuyOOsXqgvuuIipzoA%3D",
        "duration": 38,
        "id": "7527696518913019169",
        "item_id": "7527696518913019169",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7527696518913019169",
        "region": "United States"
      },
      {
        "title": "Our dream pool is not everyone’s cup of tea but we are obsessed 🤩😎🖤 #poolbuild #blackpool #blackeclipsepebblesheen #pool #backyard #backyardrenovation #az ",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/okz0H2ESiAKIBIawPOSOiD51VD1PAIcERaBU9~tplv-noop.image?t=9276707c&x-expires=1755869732&x-signature=y3m4vhweVJ%2FZdIT6vKMLcd6I1rE%3D",
        "duration": 19,
        "id": "7531090883358346527",
        "item_id": "7531090883358346527",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7531090883358346527",
        "region": "United States"
      },
      {
        "title": "not a want but a need ",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/o83FHBZ9IAVTPFEExEXi1Oe8MIpRAJiZokBrDf~tplv-noop.image?t=9276707c&x-expires=1755869719&x-signature=29XNahKDQ%2BT7vPioNmLF1Hm6mnY%3D",
        "duration": 6,
        "id": "7522242160813526303",
        "item_id": "7522242160813526303",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7522242160813526303",
        "region": "United States"
      },
      {
        "title": "The 2025 Nissan Frontier. 7150 lbs of towing max capacity, pulls you into the next great road trip. From our US factories to your driveway.",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/owI1URBoUZKfxFx32GjDHgCESEDfAudcpQQYEX~tplv-noop.image?t=9276707c&x-expires=1755869728&x-signature=D1vSAMLklPDEoPSL19baCpkiMiQ%3D",
        "duration": 15,
        "id": "7522555473187327246",
        "item_id": "7522555473187327246",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7522555473187327246",
        "region": "United States"
      },
      {
        "title": "I’m partnering with @Talenti Gelato to share this refreshing Cherry Lemon Sorbetto Parfait featuring Talenti’s Zesty Lemon Sorbetto. #TalentiPartner It’s the ultimate summer treat that’s a little sweet a little tart, and one you’ll want on repeat. #TalentiSorbetto #TalentiFirstTaste",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/ogdYkIeoopDhDkgcBoFEgFDZEXAREEiQQEf1SG~tplv-noop.image?t=9276707c&x-expires=1755869742&x-signature=SNqK9pxg8Ztm3rHfqJvRhJTwbhE%3D",
        "duration": 29,
        "id": "7519993343045127437",
        "item_id": "7519993343045127437",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7519993343045127437",
        "region": "United States"
      },
      {
        "title": "@Lightroom on Mobile is my best friend for a cute lockscreen #AdobePartner #MadeWithLightroom ",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/oMx4g7yAhSRIBiQFMHCNEyviVBpdBraAm4REA~tplv-noop.image?t=9276707c&x-expires=1755869752&x-signature=HQ2iJCfuqt8HRiOg7AhVpZ1f4mU%3D",
        "duration": 39,
        "id": "7527772337299606814",
        "item_id": "7527772337299606814",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7527772337299606814",
        "region": "United States"
      },
      {
        "title": "Eggo Buttermilk waffles asmr style. #asmr #eggowaffles",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/o4BIFLGrLIfR8S54ijQBAC0IfqDEIqBeAQp8CI~tplv-noop.image?t=9276707c&x-expires=1755869739&x-signature=JWPTgw5T%2BAULo%2FK%2BsYWLMwWyBpU%3D",
        "duration": 26,
        "id": "7528128177202351391",
        "item_id": "7528128177202351391",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7528128177202351391",
        "region": "United States"
      },
      {
        "title": "LET’S GOOO 😎 @alexojeda #waterslide #cruise #cruisetok #cruisevlog #waterpark",
        "country_code": "US",
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/oImjweBAOIzgiLOQHpPAK2vUM3sB0bBQAiBA2E~tplv-noop.image?t=9276707c&x-expires=1755869739&x-signature=qIJp%2BL3w9ex6seuI4xBlh4Np2YE%3D",
        "duration": 26,
        "id": "7486901162159967530",
        "item_id": "7486901162159967530",
        "item_url": "https://www.tiktok.com/@mnm_pipi/video/7486901162159967530",
        "region": "United States"
      }
    ],
    "pagination": {
      "page": 1,
      "totalPages": "25",
      "currentResults": 20,
      "totalCount": 500,
      "hasNextPage": true
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml api-reference/openapi-3.0.json get /wf/tiktok-trending-videos
openapi: 3.0.3
info:
  title: Riona API Docs
  version: 1.0.0
  contact:
    email: info@riona.ai
    url: https://riona.ai
servers:
  - url: https://riona.ai/api/1.1
security:
  - bearerAuth: []
tags:
  - name: Workflow
    description: Use this to trigger a workflow
  - name: Data
    description: Use this to fetch, modify and delete data
paths:
  /wf/tiktok-trending-videos:
    get:
      tags:
        - Workflow
      description: Triggers the workflow tiktok-trending-videos
      operationId: get_wf_tiktok-trending-videos
      parameters:
        - name: page
          in: query
          required: true
          description: Requested page. Returns up to 20 per page.
          schema:
            type: number
            default: 1
        - name: sort_by
          in: query
          required: false
          description: |-

            - `vv`: hot
            - `like`: like
            - `comment`: comment
            - `repost`: share
          schema:
            type: string
        - name: country
          in: query
          required: false
          description: >-
            Two letter Country code. Example: `US`. To get the full list of
            country use this endpoint: [Get Social Country
            List](/api-reference/other/countries)
          schema:
            type: string
        - name: period
          in: query
          required: false
          description: 'Period in days: `7` | `30`'
          schema:
            type: number
        - name: api_key
          in: query
          required: true
          description: >-
            This is your account API Key. You can easily locate it in your
            account dashboard.
          schema:
            type: string
      responses:
        '200':
          description: OK
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````