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

# Ranking Country🏆

> Get Twitter Top Ranking by Country

<ResponseExample>
  ```json 200 theme={null}
  {
    "status": {
      "code": 200,
      "message": "OK"
    },
    "data": [
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/BarackObama",
          "userID": "813286",
          "platform": "x",
          "name": "Barack Obama",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:813286?time=1755946545",
          "description": "Dad, husband, President, citizen.",
          "username": "BarackObama",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "influencer",
          "gender": "m",
          "age": "30_35",
          "verified": true
        },
        "stats": {
          "followers": 130547369,
          "avgLikes": 159443,
          "avgComments": 17212,
          "avgER": 0.00889775530032159,
          "avgInteractions": 198715,
          "avgViews": 23555749,
          "qualityScore": 0.789677419354839
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/NASA",
          "userID": "11348282",
          "platform": "x",
          "name": "NASA",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:11348282?time=1755953066",
          "description": "Official NASA account. Exploring the universe, advancing science, and inspiring the next generation of explorers.\n\nVerification: https://t.co/8nok3NP4PW",
          "username": "NASA",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "business",
          "gender": "",
          "age": "",
          "verified": true
        },
        "stats": {
          "followers": 87673288,
          "avgLikes": 4637,
          "avgComments": 280,
          "avgER": 20.4607745439756,
          "avgInteractions": 5978,
          "avgViews": 815512,
          "qualityScore": 0.701307189542484
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/EllenDeGeneres",
          "userID": "15846407",
          "platform": "x",
          "name": "The Ellen Show",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:15846407?time=1739772814",
          "description": "Comedian, talk show host and ice road trucker. My tweets are real, and they’re spectacular.",
          "username": "EllenDeGeneres",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "influencer",
          "gender": "m",
          "age": "30_35",
          "verified": false
        },
        "stats": {
          "followers": 73173748,
          "avgLikes": 0,
          "avgComments": 0,
          "avgER": 0,
          "avgInteractions": 0,
          "avgViews": 0,
          "qualityScore": 0.20952380952381
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/BillGates",
          "userID": "50393960",
          "platform": "x",
          "name": "Bill Gates",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:50393960?time=1755957043",
          "description": "Sharing things I'm learning through my foundation work and other interests.",
          "username": "BillGates",
          "country": "global",
          "countryCode": "",
          "city": "",
          "type": "influencer",
          "gender": "m",
          "age": "45_100",
          "verified": true
        },
        "stats": {
          "followers": 66411364,
          "avgLikes": 4068,
          "avgComments": 261,
          "avgER": 0.0093742822404955,
          "avgInteractions": 6055,
          "avgViews": 725119,
          "qualityScore": 0.677124183006536
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/nytimes",
          "userID": "807095",
          "platform": "x",
          "name": "The New York Times",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:807095?time=1756172609",
          "description": "News tips? Share them here: https://t.co/ghL9OoYKMM",
          "username": "nytimes",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "business",
          "gender": "",
          "age": "",
          "verified": true
        },
        "stats": {
          "followers": 55120366,
          "avgLikes": 250,
          "avgComments": 74,
          "avgER": 13.8433704195124,
          "avgInteractions": 449,
          "avgViews": 151798,
          "qualityScore": 0.673584905660377
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/britneyspears",
          "userID": "16409683",
          "platform": "x",
          "name": "Britney Spears 🌹🚀",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:16409683?time=1755954561",
          "description": "Artist 🎶💃🏼 Mamma 👩‍👦‍👦 Pray Every Day 🙏🏼✝️ Chef in the works💋👩🏼‍🍳",
          "username": "britneyspears",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "influencer",
          "gender": "f",
          "age": "24_27",
          "verified": true
        },
        "stats": {
          "followers": 53335605,
          "avgLikes": 0,
          "avgComments": 0,
          "avgER": 0,
          "avgInteractions": 0,
          "avgViews": 0,
          "qualityScore": 0.21437908496732
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/KingJames",
          "userID": "23083404",
          "platform": "x",
          "name": "LeBron James",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:23083404?time=1755947246",
          "description": "EST. AKRON - ST.V/M Class of '03 https://t.co/TrZZrgA5Yt #IPROMISE",
          "username": "KingJames",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "influencer",
          "gender": "m",
          "age": "45_100",
          "verified": true
        },
        "stats": {
          "followers": 52838031,
          "avgLikes": 65988,
          "avgComments": 944,
          "avgER": 3.66895683854315,
          "avgInteractions": 71883,
          "avgViews": 4229661,
          "qualityScore": 0.756129032258065
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/ddlovato",
          "userID": "21111883",
          "platform": "x",
          "name": "Demi Lovato",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:21111883?time=1755953240",
          "description": "FAST OUT NOW ⏩",
          "username": "ddlovato",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "influencer",
          "gender": "m",
          "age": "21_24",
          "verified": true
        },
        "stats": {
          "followers": 51268109,
          "avgLikes": 10491,
          "avgComments": 605,
          "avgER": 481.874121336128,
          "avgInteractions": 15028,
          "avgViews": 743021,
          "qualityScore": 0.709150326797386
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/jimmyfallon",
          "userID": "15485441",
          "platform": "x",
          "name": "Jimmy Fallon",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:15485441?time=1755954966",
          "description": "astrophysicist",
          "username": "jimmyfallon",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "influencer",
          "gender": "m",
          "age": "35_45",
          "verified": true
        },
        "stats": {
          "followers": 48652727,
          "avgLikes": 1423,
          "avgComments": 222,
          "avgER": 68.6337238567175,
          "avgInteractions": 2059,
          "avgViews": 549312,
          "qualityScore": 0.595424836601307
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/NBA",
          "userID": "19923144",
          "platform": "x",
          "name": "NBA",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:19923144?time=1755955196",
          "description": "It's NBA Assist Week! Join us as we recap the best of 2024-25 in the NBA 🍿",
          "username": "NBA",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "business",
          "gender": "",
          "age": "",
          "verified": false
        },
        "stats": {
          "followers": 48403401,
          "avgLikes": 755,
          "avgComments": 45,
          "avgER": 6.91457074545389,
          "avgInteractions": 947,
          "avgViews": 234843,
          "qualityScore": 0.616339869281046
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/MileyCyrus",
          "userID": "268414482",
          "platform": "x",
          "name": "Miley Cyrus",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:268414482?time=1755955156",
          "description": "Something Beautiful the album out now. Watch the film on Disney+ & Hulu.",
          "username": "MileyCyrus",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "influencer",
          "gender": "f",
          "age": "30_35",
          "verified": true
        },
        "stats": {
          "followers": 45342933,
          "avgLikes": 6258,
          "avgComments": 165,
          "avgER": 15.0963668867385,
          "avgInteractions": 7352,
          "avgViews": 270595,
          "qualityScore": 0.633333333333333
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/SportsCenter",
          "userID": "26257166",
          "platform": "x",
          "name": "SportsCenter",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:26257166?time=1755955257",
          "description": "Sign up for ESPN! https://t.co/DgtvQmN9zs\nQuestions about your subscription? https://t.co/qNSh3HmYD1",
          "username": "SportsCenter",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "business",
          "gender": "",
          "age": "",
          "verified": true
        },
        "stats": {
          "followers": 45062925,
          "avgLikes": 2774,
          "avgComments": 92,
          "avgER": 55.6162980534503,
          "avgInteractions": 3262,
          "avgViews": 463750,
          "qualityScore": 0.668627450980392
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/BrunoMars",
          "userID": "100220864",
          "platform": "x",
          "name": "Bruno Mars",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:100220864?time=1755955227",
          "description": "",
          "username": "BrunoMars",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "business",
          "gender": "",
          "age": "",
          "verified": true
        },
        "stats": {
          "followers": 41696873,
          "avgLikes": 50644,
          "avgComments": 1364,
          "avgER": 0.0426318045844065,
          "avgInteractions": 62549,
          "avgViews": 1467191,
          "qualityScore": 0.70718954248366
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/Oprah",
          "userID": "19397785",
          "platform": "x",
          "name": "Oprah Winfrey",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:19397785?time=1755955264",
          "description": "",
          "username": "Oprah",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "influencer",
          "gender": "f",
          "age": "35_45",
          "verified": true
        },
        "stats": {
          "followers": 40480269,
          "avgLikes": 0,
          "avgComments": 0,
          "avgER": 0,
          "avgInteractions": 0,
          "avgViews": 0,
          "qualityScore": 0.209803921568627
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/SpaceX",
          "userID": "34743251",
          "platform": "x",
          "name": "SpaceX",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:34743251?time=1755957402",
          "description": "SpaceX designs, manufactures and launches the world’s most advanced rockets and spacecraft",
          "username": "SpaceX",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "business",
          "gender": "",
          "age": "",
          "verified": true
        },
        "stats": {
          "followers": 39811065,
          "avgLikes": 5823,
          "avgComments": 322,
          "avgER": 12.0404215633616,
          "avgInteractions": 7212,
          "avgViews": 1483438,
          "qualityScore": 0.754248366013072
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/JoeBiden",
          "userID": "939091",
          "platform": "x",
          "name": "Joe Biden",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:939091?time=1755948217",
          "description": "Husband to @DrBiden, proud father, grandfather, and great grandfather.",
          "username": "JoeBiden",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "influencer",
          "gender": "m",
          "age": "45_100",
          "verified": true
        },
        "stats": {
          "followers": 38093356,
          "avgLikes": 20919,
          "avgComments": 4729,
          "avgER": 0.0177034285083893,
          "avgInteractions": 29342,
          "avgViews": 1696916,
          "qualityScore": 0.696129032258065
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/NFL",
          "userID": "19426551",
          "platform": "x",
          "name": "NFL",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:19426551?time=1755945923",
          "description": "offseason progress bar █████████▒92%",
          "username": "NFL",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "business",
          "gender": "",
          "age": "",
          "verified": true
        },
        "stats": {
          "followers": 37875065,
          "avgLikes": 2517,
          "avgComments": 101,
          "avgER": 15.2264574401923,
          "avgInteractions": 2842,
          "avgViews": 652777,
          "qualityScore": 0.665806451612903
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/KevinHart4real",
          "userID": "23151437",
          "platform": "x",
          "name": "Kevin Hart",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:23151437?time=1755945831",
          "description": "My name is Kevin Hart and I WORK HARD!!! That pretty much sums me up!!! Everybody Wants To Be Famous But Nobody Wants To Do The Work",
          "username": "KevinHart4real",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "influencer",
          "gender": "m",
          "age": "35_45",
          "verified": true
        },
        "stats": {
          "followers": 36029693,
          "avgLikes": 329,
          "avgComments": 95,
          "avgER": 0.00353615255594466,
          "avgInteractions": 463,
          "avgViews": 135051,
          "qualityScore": 0.453548387096774
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/wizkhalifa",
          "userID": "20322929",
          "platform": "x",
          "name": "Wiz Khalifa",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:20322929?time=1755957317",
          "description": "Taylor Gang the World",
          "username": "wizkhalifa",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "influencer",
          "gender": "m",
          "age": "30_35",
          "verified": true
        },
        "stats": {
          "followers": 35369517,
          "avgLikes": 280,
          "avgComments": 19,
          "avgER": 10.8185114564181,
          "avgInteractions": 391,
          "avgViews": 55879,
          "qualityScore": 0.505882352941176
        }
      },
      {
        "profile": {
          "masterID": "",
          "url": "https://x.com/LilTunechi",
          "userID": "116362700",
          "platform": "x",
          "name": "Lil Wayne WEEZY F",
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:116362700?time=1755955955",
          "description": "Call me Mr. Carter",
          "username": "LilTunechi",
          "country": "united-states",
          "countryCode": "US",
          "city": "",
          "type": "influencer",
          "gender": "m",
          "age": "30_35",
          "verified": true
        },
        "stats": {
          "followers": 33750212,
          "avgLikes": 2526,
          "avgComments": 114,
          "avgER": 26.0070588257554,
          "avgInteractions": 2864,
          "avgViews": 264740,
          "qualityScore": 0.592156862745098
        }
      }
    ],
    "pagination": {
      "currentPage": 1,
      "totalPages": 176,
      "currentResults": 20,
      "totalCount": 3504,
      "nextPage": true
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml api-reference/openapi-3.0.json get /wf/twitter-ranking-country
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-ranking-country:
    get:
      tags:
        - Workflow
      description: Triggers the workflow twitter-ranking-country
      operationId: get_wf_twitter-ranking-country
      parameters:
        - name: country
          in: query
          required: true
          description: >-
            Example: `united-states`. To get the full list of country use this
            endpoint: [Country List](/api-reference/other/countries)
          schema:
            type: string
        - name: page
          in: query
          required: true
          description: Requested page. Every page returns 20 profiles.
          schema:
            type: number
            default: 1
        - 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

````