> ## 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 Keywords

> Get TikTok Trending Keywords

<ResponseExample>
  ```json 200 theme={null}
  {
    "status": {
      "code": 200,
      "message": "OK"
    },
    "keyword_list": [
      {
        "comment": 51493,
        "cost": 7790000,
        "cpa": 11.5,
        "ctr": 0.67,
        "cvr": 12.95,
        "impression": 1680000000,
        "keyword": "summer",
        "like": 6132175,
        "play_six_rate": 7.28,
        "post": 91100,
        "post_change": 900.18,
        "share": 73265,
        "video_list": [
          "7509236475238681857",
          "7516570469210852616",
          "7511483560939785514",
          "7511370341621435679",
          "7509181478979472648"
        ]
      },
      {
        "comment": 58206,
        "cost": 6570000,
        "cpa": 17.4,
        "ctr": 1.38,
        "cvr": 6.23,
        "impression": 918000000,
        "keyword": "free shipping",
        "like": 2312521,
        "play_six_rate": 8.98,
        "post": 64600,
        "post_change": 170.74,
        "share": 115441,
        "video_list": [
          "7494383313587571985",
          "7473177402600934698",
          "7515191469112691976",
          "7502568005495246097",
          "7387096339684936976"
        ]
      },
      {
        "comment": 7017,
        "cost": 945000,
        "cpa": 13.6,
        "ctr": 1.46,
        "cvr": 6.93,
        "impression": 161000000,
        "keyword": "shoe",
        "like": 357255,
        "play_six_rate": 7.66,
        "post": 43100,
        "post_change": 302.63,
        "share": 10998,
        "video_list": [
          "7530365572199075090",
          "7530371676534656273",
          "7498895905672760583",
          "7525852193593871630",
          "7524268460864474382"
        ]
      },
      {
        "comment": 6460,
        "cost": 734000,
        "cpa": 15.7,
        "ctr": 1.61,
        "cvr": 5.33,
        "impression": 126000000,
        "keyword": "shoes",
        "like": 320092,
        "play_six_rate": 8.21,
        "post": 40500,
        "post_change": 310.65,
        "share": 10179,
        "video_list": [
          "7530371676534656273",
          "7498895905672760583",
          "7525852193593871630",
          "7524268460864474382",
          "7499553523235933447"
        ]
      },
      {
        "comment": 14482,
        "cost": 1460000,
        "cpa": 17.4,
        "ctr": 1.33,
        "cvr": 5.82,
        "impression": 226000000,
        "keyword": "men",
        "like": 342208,
        "play_six_rate": 8.2,
        "post": 33500,
        "post_change": 260.09,
        "share": 20027,
        "video_list": [
          "7481436344758144273",
          "7486555668506217744",
          "7520042969802624264",
          "7517412691338693905",
          "7520040438892399889"
        ]
      },
      {
        "comment": 9031,
        "cost": 1170000,
        "cpa": 9.99,
        "ctr": 1.74,
        "cvr": 8.24,
        "impression": 170000000,
        "keyword": "dress",
        "like": 1140807,
        "play_six_rate": 9.56,
        "post": 28500,
        "post_change": 318.44,
        "share": 13039,
        "video_list": [
          "7509589850647973151",
          "7510867032926211371",
          "7506823439676689682",
          "7522205854309879053",
          "7498798801252125969"
        ]
      },
      {
        "comment": 88323,
        "cost": 8580000,
        "cpa": 0.92,
        "ctr": 1.09,
        "cvr": 100,
        "impression": 1520000000,
        "keyword": "for free",
        "like": 4168260,
        "play_six_rate": 10.74,
        "post": 23900,
        "post_change": 117.03,
        "share": 39215,
        "video_list": [
          "7492099723050929416",
          "7503603452090535186",
          "7489164223231167751",
          "7509768680268434706",
          "7505000994078559496"
        ]
      },
      {
        "comment": 8563,
        "cost": 1400000,
        "cpa": 25.3,
        "ctr": 1.31,
        "cvr": 4.96,
        "impression": 170000000,
        "keyword": "50% off",
        "like": 685564,
        "play_six_rate": 11.34,
        "post": 23100,
        "post_change": 152.86,
        "share": 13925,
        "video_list": [
          "7505005948876967214",
          "7532607228457553159",
          "7509942304925322504",
          "7498327719709510913",
          "7516260249372773650"
        ]
      },
      {
        "comment": 25022,
        "cost": 4140000,
        "cpa": 3.61,
        "ctr": 1.03,
        "cvr": 34.31,
        "impression": 681000000,
        "keyword": "shop now",
        "like": 1582691,
        "play_six_rate": 6.6,
        "post": 22100,
        "post_change": 140.39,
        "share": 36301,
        "video_list": [
          "7498363245640568072",
          "7498363230666951937",
          "7494759211524459792",
          "7522995753447329040",
          "7491312838515100974"
        ]
      },
      {
        "comment": 48247,
        "cost": 3280000,
        "cpa": 2.44,
        "ctr": 1.02,
        "cvr": 43.78,
        "impression": 616000000,
        "keyword": "free",
        "like": 1319963,
        "play_six_rate": 10.16,
        "post": 17200,
        "post_change": 179.08,
        "share": 19233,
        "video_list": [
          "7491855425457884417",
          "7485873855160913160",
          "7491472935396314375",
          "7491863973508205842",
          "7426275467650436357"
        ]
      },
      {
        "comment": 17206,
        "cost": 2170000,
        "cpa": 23.2,
        "ctr": 2.15,
        "cvr": 4.78,
        "impression": 202000000,
        "keyword": "flash sale",
        "like": 654364,
        "play_six_rate": 11.39,
        "post": 16600,
        "post_change": 149.36,
        "share": 30354,
        "video_list": [
          "7509134564049079560",
          "7489561443424128287",
          "7496205691976158495",
          "7485915485410823466",
          "7477795741960817950"
        ]
      },
      {
        "comment": 11055,
        "cost": 2040000,
        "cpa": 7.59,
        "ctr": 1.85,
        "cvr": 9.3,
        "impression": 327000000,
        "keyword": "for summer",
        "like": 1393554,
        "play_six_rate": 8.35,
        "post": 16200,
        "post_change": 655.08,
        "share": 19270,
        "video_list": [
          "7507077455321124114",
          "7512749467242695982",
          "7507614112692604190",
          "7525500670607248648",
          "7530061565794585872"
        ]
      },
      {
        "comment": 2903,
        "cost": 217000,
        "cpa": 11.9,
        "ctr": 1.63,
        "cvr": 5.97,
        "impression": 39800000,
        "keyword": "tshirt",
        "like": 126892,
        "play_six_rate": 8.48,
        "post": 16200,
        "post_change": 359.6,
        "share": 4096,
        "video_list": [
          "7526821959221382431",
          "7532045446810815757",
          "7524401944555834655",
          "7530205946832768311",
          "7531309249201212686"
        ]
      },
      {
        "comment": 4371,
        "cost": 565000,
        "cpa": 16.7,
        "ctr": 1.66,
        "cvr": 5.74,
        "impression": 77900000,
        "keyword": "shorts",
        "like": 280585,
        "play_six_rate": 7.99,
        "post": 16100,
        "post_change": 448.26,
        "share": 4257,
        "video_list": [
          "7536930415114800402",
          "7488860097981041966",
          "7490492446799924523",
          "7503944976384920839",
          "7502501098943450398"
        ]
      },
      {
        "comment": 22005,
        "cost": 4000000,
        "cpa": 3.5,
        "ctr": 0.73,
        "cvr": 42.62,
        "impression": 734000000,
        "keyword": "this summer",
        "like": 2355772,
        "play_six_rate": 6.14,
        "post": 16000,
        "post_change": 834.22,
        "share": 29779,
        "video_list": [
          "7515164780466949377",
          "7506892602772426001",
          "7510252254096608520",
          "7530666596495346975",
          "7521581658324208903"
        ]
      },
      {
        "comment": 4337,
        "cost": 996000,
        "cpa": 12.7,
        "ctr": 0.65,
        "cvr": 11,
        "impression": 241000000,
        "keyword": "bag",
        "like": 310965,
        "play_six_rate": 3.2,
        "post": 14800,
        "post_change": 196.01,
        "share": 4212,
        "video_list": [
          "7519579350182661384",
          "7514115646674701576",
          "7500680021581925678",
          "7485900434230562064",
          "7512226118200511760"
        ]
      },
      {
        "comment": 5144,
        "cost": 449000,
        "cpa": 8.34,
        "ctr": 3.56,
        "cvr": 8.13,
        "impression": 39800000,
        "keyword": "wig",
        "like": 311586,
        "play_six_rate": 15.3,
        "post": 14400,
        "post_change": 159.3,
        "share": 7618,
        "video_list": [
          "7450392982727183662",
          "7535344132143844625",
          "7503715896020553003",
          "7535118829458853127",
          "7515154704175877422"
        ]
      },
      {
        "comment": 2977,
        "cost": 732000,
        "cpa": 32.6,
        "ctr": 0.43,
        "cvr": 6.83,
        "impression": 165000000,
        "keyword": "kids",
        "like": 372931,
        "play_six_rate": 7.22,
        "post": 14000,
        "post_change": 224.84,
        "share": 4542,
        "video_list": [
          "7521867398278925575",
          "7491322443198418184",
          "7522567501205589262",
          "7499938162605690142",
          "7508803945947581742"
        ]
      },
      {
        "comment": 2553,
        "cost": 319000,
        "cpa": 11.5,
        "ctr": 2.49,
        "cvr": 7.4,
        "impression": 32200000,
        "keyword": "watch",
        "like": 113141,
        "play_six_rate": 14.08,
        "post": 13800,
        "post_change": 192.71,
        "share": 4078,
        "video_list": [
          "7483937540463070510",
          "7526533194259238152",
          "7393073069641829649",
          "7507343641128488235",
          "7487708026451840278"
        ]
      },
      {
        "comment": 54686,
        "cost": 8970000,
        "cpa": 9.91,
        "ctr": 0.54,
        "cvr": 21.52,
        "impression": 1660000000,
        "keyword": "learn more",
        "like": 2029366,
        "play_six_rate": 5.22,
        "post": 13200,
        "post_change": 114.18,
        "share": 41677,
        "video_list": [
          "7458299139277786410",
          "7491770671878458666",
          "7488052297482636562",
          "7493985662715038984",
          "7475403121494101256"
        ]
      }
    ],
    "pagination": {
      "page": 1,
      "totalPages": 24,
      "currentResults": 20,
      "totalCount": 477,
      "hasNextPage": true
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml api-reference/openapi-3.0.json get /wf/tiktok-trending-keywords
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-keywords:
    get:
      tags:
        - Workflow
      description: Triggers the workflow tiktok-trending-keywords
      operationId: get_wf_tiktok-trending-keywords
      parameters:
        - name: page
          in: query
          required: true
          description: Requested page
          schema:
            type: number
            default: 1
        - 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` | `120`'
          schema:
            type: number
        - name: categories
          in: query
          required: false
          description: >-
            You can combine multiple categories by using a comma. Example
            categories: `22102000000` `22101000000`

            To get the full list of TikTok Categories use this endpoint: [Get
            TikTok Category List](/api-reference/tiktok/category-list)
          schema:
            type: string
        - name: goal
          in: query
          required: false
          description: >-
            Possible options: `traffic` | `app_installs` | `conversions` |
            `video_views` | `reach` | `lead_generation` | `product_sales`
          schema:
            type: string
        - name: keyword_type
          in: query
          required: false
          description: >-
            Possible options: `selling_points` | `pain_points` |
            `target_audience` | `call_to_action` | `other` | `products`
          schema:
            type: string
        - 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

````