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

# User Stories

> Get Twitter Trends and Hashtags

<ResponseExample>
  ```json 200 theme={null}
  {
    "meta": {
      "code": 200,
      "message": "OK"
    },
    "location": {
      "country": "United States",
      "code": "US"
    },
    "trends": [
      {
        "name": "Cardi",
        "url": "http://twitter.com/search?q=Cardi",
        "promoted_content": "",
        "query": "Cardi",
        "tweet_volume": 90006
      },
      {
        "name": "#kvants",
        "url": "http://twitter.com/search?q=%23kvants",
        "promoted_content": "",
        "query": "%23kvants",
        "tweet_volume": 0
      },
      {
        "name": "Constitution Day",
        "url": "http://twitter.com/search?q=%22Constitution+Day%22",
        "promoted_content": "",
        "query": "%22Constitution+Day%22",
        "tweet_volume": 19043
      },
      {
        "name": "Offset",
        "url": "http://twitter.com/search?q=Offset",
        "promoted_content": "",
        "query": "Offset",
        "tweet_volume": 11124
      },
      {
        "name": "King Charles",
        "url": "http://twitter.com/search?q=%22King+Charles%22",
        "promoted_content": "",
        "query": "%22King+Charles%22",
        "tweet_volume": 38314
      },
      {
        "name": "Pat Bev",
        "url": "http://twitter.com/search?q=%22Pat+Bev%22",
        "promoted_content": "",
        "query": "%22Pat+Bev%22",
        "tweet_volume": 0
      },
      {
        "name": "Stefon",
        "url": "http://twitter.com/search?q=Stefon",
        "promoted_content": "",
        "query": "Stefon",
        "tweet_volume": 14853
      },
      {
        "name": "Unilever",
        "url": "http://twitter.com/search?q=Unilever",
        "promoted_content": "",
        "query": "Unilever",
        "tweet_volume": 30445
      },
      {
        "name": "Graham Norton",
        "url": "http://twitter.com/search?q=%22Graham+Norton%22",
        "promoted_content": "",
        "query": "%22Graham+Norton%22",
        "tweet_volume": 0
      },
      {
        "name": "Windsor Castle",
        "url": "http://twitter.com/search?q=%22Windsor+Castle%22",
        "promoted_content": "",
        "query": "%22Windsor+Castle%22",
        "tweet_volume": 111521
      },
      {
        "name": "Trae",
        "url": "http://twitter.com/search?q=Trae",
        "promoted_content": "",
        "query": "Trae",
        "tweet_volume": 12311
      },
      {
        "name": "Montel",
        "url": "http://twitter.com/search?q=Montel",
        "promoted_content": "",
        "query": "Montel",
        "tweet_volume": 23108
      },
      {
        "name": "Kimmel",
        "url": "http://twitter.com/search?q=Kimmel",
        "promoted_content": "",
        "query": "Kimmel",
        "tweet_volume": 81034
      },
      {
        "name": "Dearborn",
        "url": "http://twitter.com/search?q=Dearborn",
        "promoted_content": "",
        "query": "Dearborn",
        "tweet_volume": 77180
      },
      {
        "name": "FOMC",
        "url": "http://twitter.com/search?q=FOMC",
        "promoted_content": "",
        "query": "FOMC",
        "tweet_volume": 61894
      },
      {
        "name": "Charlie King",
        "url": "http://twitter.com/search?q=%22Charlie+King%22",
        "promoted_content": "",
        "query": "%22Charlie+King%22",
        "tweet_volume": 17954
      },
      {
        "name": "U.S. Constitution",
        "url": "http://twitter.com/search?q=%22U.S.+Constitution%22",
        "promoted_content": "",
        "query": "%22U.S.+Constitution%22",
        "tweet_volume": 0
      },
      {
        "name": "Tropical Storm Gabrielle",
        "url": "http://twitter.com/search?q=%22Tropical+Storm+Gabrielle%22",
        "promoted_content": "",
        "query": "%22Tropical+Storm+Gabrielle%22",
        "tweet_volume": 0
      },
      {
        "name": "Anaconda",
        "url": "http://twitter.com/search?q=Anaconda",
        "promoted_content": "",
        "query": "Anaconda",
        "tweet_volume": 10624
      },
      {
        "name": "Jack Black",
        "url": "http://twitter.com/search?q=%22Jack+Black%22",
        "promoted_content": "",
        "query": "%22Jack+Black%22",
        "tweet_volume": 0
      },
      {
        "name": "Tucker",
        "url": "http://twitter.com/search?q=Tucker",
        "promoted_content": "",
        "query": "Tucker",
        "tweet_volume": 143553
      },
      {
        "name": "#WednesdayMotivation",
        "url": "http://twitter.com/search?q=%23WednesdayMotivation",
        "promoted_content": "",
        "query": "%23WednesdayMotivation",
        "tweet_volume": 0
      },
      {
        "name": "Queen Elizabeth",
        "url": "http://twitter.com/search?q=%22Queen+Elizabeth%22",
        "promoted_content": "",
        "query": "%22Queen+Elizabeth%22",
        "tweet_volume": 0
      },
      {
        "name": "Susan Monarez",
        "url": "http://twitter.com/search?q=%22Susan+Monarez%22",
        "promoted_content": "",
        "query": "%22Susan+Monarez%22",
        "tweet_volume": 0
      },
      {
        "name": "Hump Day",
        "url": "http://twitter.com/search?q=%22Hump+Day%22",
        "promoted_content": "",
        "query": "%22Hump+Day%22",
        "tweet_volume": 18235
      },
      {
        "name": "Cysic",
        "url": "http://twitter.com/search?q=Cysic",
        "promoted_content": "",
        "query": "Cysic",
        "tweet_volume": 33683
      },
      {
        "name": "CILLIAN",
        "url": "http://twitter.com/search?q=CILLIAN",
        "promoted_content": "",
        "query": "CILLIAN",
        "tweet_volume": 19728
      },
      {
        "name": "Hanoi Jane",
        "url": "http://twitter.com/search?q=%22Hanoi+Jane%22",
        "promoted_content": "",
        "query": "%22Hanoi+Jane%22",
        "tweet_volume": 0
      },
      {
        "name": "Tyrod Taylor",
        "url": "http://twitter.com/search?q=%22Tyrod+Taylor%22",
        "promoted_content": "",
        "query": "%22Tyrod+Taylor%22",
        "tweet_volume": 0
      },
      {
        "name": "Good Wednesday",
        "url": "http://twitter.com/search?q=%22Good+Wednesday%22",
        "promoted_content": "",
        "query": "%22Good+Wednesday%22",
        "tweet_volume": 32402
      },
      {
        "name": "Powell",
        "url": "http://twitter.com/search?q=Powell",
        "promoted_content": "",
        "query": "Powell",
        "tweet_volume": 40691
      },
      {
        "name": "Paul Rudd",
        "url": "http://twitter.com/search?q=%22Paul+Rudd%22",
        "promoted_content": "",
        "query": "%22Paul+Rudd%22",
        "tweet_volume": 0
      },
      {
        "name": "Conrad",
        "url": "http://twitter.com/search?q=Conrad",
        "promoted_content": "",
        "query": "Conrad",
        "tweet_volume": 111786
      },
      {
        "name": "#IndianaJones",
        "url": "http://twitter.com/search?q=%23IndianaJones",
        "promoted_content": "",
        "query": "%23IndianaJones",
        "tweet_volume": 0
      },
      {
        "name": "#tsitpfinale",
        "url": "http://twitter.com/search?q=%23tsitpfinale",
        "promoted_content": "",
        "query": "%23tsitpfinale",
        "tweet_volume": 0
      },
      {
        "name": "#TheSummerITurnedPretty",
        "url": "http://twitter.com/search?q=%23TheSummerITurnedPretty",
        "promoted_content": "",
        "query": "%23TheSummerITurnedPretty",
        "tweet_volume": 124970
      },
      {
        "name": "Gayle",
        "url": "http://twitter.com/search?q=Gayle",
        "promoted_content": "",
        "query": "Gayle",
        "tweet_volume": 0
      },
      {
        "name": "Ben and Jerry",
        "url": "http://twitter.com/search?q=%22Ben+and+Jerry%22",
        "promoted_content": "",
        "query": "%22Ben+and+Jerry%22",
        "tweet_volume": 27337
      },
      {
        "name": "Preston Smith",
        "url": "http://twitter.com/search?q=%22Preston+Smith%22",
        "promoted_content": "",
        "query": "%22Preston+Smith%22",
        "tweet_volume": 0
      },
      {
        "name": "Jerry Greenfield",
        "url": "http://twitter.com/search?q=%22Jerry+Greenfield%22",
        "promoted_content": "",
        "query": "%22Jerry+Greenfield%22",
        "tweet_volume": 26362
      },
      {
        "name": "Coates",
        "url": "http://twitter.com/search?q=Coates",
        "promoted_content": "",
        "query": "Coates",
        "tweet_volume": 0
      },
      {
        "name": "Gen V",
        "url": "http://twitter.com/search?q=%22Gen+V%22",
        "promoted_content": "",
        "query": "%22Gen+V%22",
        "tweet_volume": 11559
      },
      {
        "name": "$LYFT",
        "url": "http://twitter.com/search?q=%24LYFT",
        "promoted_content": "",
        "query": "%24LYFT",
        "tweet_volume": 11006
      },
      {
        "name": "Camilla",
        "url": "http://twitter.com/search?q=Camilla",
        "promoted_content": "",
        "query": "Camilla",
        "tweet_volume": 17559
      },
      {
        "name": "Ben & Jerry",
        "url": "http://twitter.com/search?q=%22Ben+%26+Jerry%22",
        "promoted_content": "",
        "query": "%22Ben+%26+Jerry%22",
        "tweet_volume": 60568
      },
      {
        "name": "$NVDA",
        "url": "http://twitter.com/search?q=%24NVDA",
        "promoted_content": "",
        "query": "%24NVDA",
        "tweet_volume": 39568
      },
      {
        "name": "Happy Hump",
        "url": "http://twitter.com/search?q=%22Happy+Hump%22",
        "promoted_content": "",
        "query": "%22Happy+Hump%22",
        "tweet_volume": 11605
      },
      {
        "name": "Tropic Thunder",
        "url": "http://twitter.com/search?q=%22Tropic+Thunder%22",
        "promoted_content": "",
        "query": "%22Tropic+Thunder%22",
        "tweet_volume": 0
      },
      {
        "name": "Invisible",
        "url": "http://twitter.com/search?q=Invisible",
        "promoted_content": "",
        "query": "Invisible",
        "tweet_volume": 29371
      },
      {
        "name": "Mid-Autumn",
        "url": "http://twitter.com/search?q=Mid-Autumn",
        "promoted_content": "",
        "query": "Mid-Autumn",
        "tweet_volume": 0
      }
    ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml api-reference/openapi-3.0.json get /wf/twitter-trends
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/twitter-trends:
    get:
      tags:
        - Workflow
      description: Triggers the workflow twitter-trends
      operationId: get_wf_twitter-trends
      parameters:
        - name: countryCode
          in: query
          required: true
          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: 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

````