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

# Demographic Data

> Get Channel demographic data like age, genders, audience countries and more.

<ResponseExample>
  ```json 200 theme={null}
  {
    "status": {
      "code": 200,
      "message": "OK"
    },
    "demographic": {
      "followersCities": [
        {
          "category": "birmingham",
          "name": "Birmingham",
          "value": 0.142857142857143
        },
        {
          "category": "long-beach",
          "name": "Long Beach",
          "value": 0.0714285714285714
        },
        {
          "category": "dallas",
          "name": "Dallas",
          "value": 0.0714285714285714
        },
        {
          "category": "dubai",
          "name": "Dubai",
          "value": 0.0714285714285714
        },
        {
          "category": "perth",
          "name": "Perth",
          "value": 0.0714285714285714
        },
        {
          "category": "orlando",
          "name": "Orlando",
          "value": 0.0714285714285714
        },
        {
          "category": "london",
          "name": "London",
          "value": 0.0714285714285714
        },
        {
          "category": "delhi",
          "name": "Delhi",
          "value": 0.0714285714285714
        },
        {
          "category": "los-angeles",
          "name": "Los Angeles",
          "value": 0.0714285714285714
        },
        {
          "category": "mexico-city",
          "name": "Mexico City",
          "value": 0.0714285714285714
        },
        {
          "category": "miami",
          "name": "Miami",
          "value": 0.0714285714285714
        },
        {
          "category": "california",
          "name": "California",
          "value": 0.0714285714285714
        },
        {
          "category": "sao-paulo",
          "name": "Sao Paulo",
          "value": 0.0714285714285714
        }
      ],
      "followersCountries": [
        {
          "category": "united-states",
          "name": "United States",
          "value": 0.548492257538712
        },
        {
          "category": "united-kingdom",
          "name": "United Kingdom",
          "value": 0.0709046454767726
        },
        {
          "category": "india",
          "name": "India",
          "value": 0.0546047269763651
        },
        {
          "category": "canada",
          "name": "Canada",
          "value": 0.052159739201304
        },
        {
          "category": "australia",
          "name": "Australia",
          "value": 0.0334148329258354
        },
        {
          "category": "philippines",
          "name": "Philippines",
          "value": 0.0244498777506112
        },
        {
          "category": "germany",
          "name": "Germany",
          "value": 0.0114099429502852
        },
        {
          "category": "bangladesh",
          "name": "Bangladesh",
          "value": 0.0110024449877751
        },
        {
          "category": "russia",
          "name": "Russia",
          "value": 0.0101874490627547
        },
        {
          "category": "indonesia",
          "name": "Indonesia",
          "value": 0.00937245313773431
        },
        {
          "category": "pakistan",
          "name": "Pakistan",
          "value": 0.00855745721271394
        },
        {
          "category": "brazil",
          "name": "Brazil",
          "value": 0.00814995925020375
        },
        {
          "category": "france",
          "name": "France",
          "value": 0.00814995925020375
        },
        {
          "category": "netherlands",
          "name": "Netherlands",
          "value": 0.00774246128769356
        },
        {
          "category": "mexico",
          "name": "Mexico",
          "value": 0.00692746536267319
        },
        {
          "category": "poland",
          "name": "Poland",
          "value": 0.00611246943765281
        },
        {
          "category": "united-arab-emirates",
          "name": "United Arab Emirates",
          "value": 0.00570497147514262
        },
        {
          "category": "malaysia",
          "name": "Malaysia",
          "value": 0.00570497147514262
        },
        {
          "category": "new-zealand",
          "name": "New Zealand",
          "value": 0.00570497147514262
        },
        {
          "category": "spain",
          "name": "Spain",
          "value": 0.00488997555012225
        },
        {
          "category": "south-africa",
          "name": "South Africa",
          "value": 0.00448247758761206
        },
        {
          "category": "romania",
          "name": "Romania",
          "value": 0.00407497962510187
        },
        {
          "category": "japan",
          "name": "Japan",
          "value": 0.00407497962510187
        },
        {
          "category": "ireland",
          "name": "Ireland",
          "value": 0.00366748166259169
        },
        {
          "category": "turkey",
          "name": "Turkey",
          "value": 0.0032599837000815
        },
        {
          "category": "south-korea",
          "name": "South Korea",
          "value": 0.0032599837000815
        },
        {
          "category": "vietnam",
          "name": "Vietnam",
          "value": 0.00285248573757131
        },
        {
          "category": "ukraine",
          "name": "Ukraine",
          "value": 0.00285248573757131
        },
        {
          "category": "finland",
          "name": "Finland",
          "value": 0.00285248573757131
        },
        {
          "category": "sweden",
          "name": "Sweden",
          "value": 0.00285248573757131
        },
        {
          "category": "switzerland",
          "name": "Switzerland",
          "value": 0.00285248573757131
        },
        {
          "category": "egypt",
          "name": "Egypt",
          "value": 0.00285248573757131
        },
        {
          "category": "greece",
          "name": "Greece",
          "value": 0.00244498777506112
        },
        {
          "category": "tanzania",
          "name": "Tanzania",
          "value": 0.00244498777506112
        },
        {
          "category": "denmark",
          "name": "Denmark",
          "value": 0.00244498777506112
        },
        {
          "category": "colombia",
          "name": "Colombia",
          "value": 0.00244498777506112
        },
        {
          "category": "iraq",
          "name": "Iraq",
          "value": 0.00203748981255094
        },
        {
          "category": "hungary",
          "name": "Hungary",
          "value": 0.00203748981255094
        },
        {
          "category": "lebanon",
          "name": "Lebanon",
          "value": 0.00203748981255094
        },
        {
          "category": "italy",
          "name": "Italy",
          "value": 0.00203748981255094
        },
        {
          "category": "portugal",
          "name": "Portugal",
          "value": 0.00203748981255094
        },
        {
          "category": "peru",
          "name": "Peru",
          "value": 0.00203748981255094
        },
        {
          "category": "thailand",
          "name": "Thailand",
          "value": 0.00203748981255094
        },
        {
          "category": "argentina",
          "name": "Argentina",
          "value": 0.00162999185004075
        },
        {
          "category": "morocco",
          "name": "Morocco",
          "value": 0.00162999185004075
        },
        {
          "category": "cambodia",
          "name": "Cambodia",
          "value": 0.00162999185004075
        },
        {
          "category": "british-indian-ocean-territory",
          "name": "British Indian Ocean Territory",
          "value": 0.00162999185004075
        },
        {
          "category": "nigeria",
          "name": "Nigeria",
          "value": 0.00162999185004075
        },
        {
          "category": "niger",
          "name": "Niger",
          "value": 0.00162999185004075
        },
        {
          "category": "singapore",
          "name": "Singapore",
          "value": 0.00162999185004075
        },
        {
          "category": "belarus",
          "name": "Belarus",
          "value": 0.00122249388753056
        },
        {
          "category": "algeria",
          "name": "Algeria",
          "value": 0.00122249388753056
        },
        {
          "category": "kenya",
          "name": "Kenya",
          "value": 0.00122249388753056
        },
        {
          "category": "taiwan",
          "name": "Taiwan",
          "value": 0.00122249388753056
        },
        {
          "category": "belgium",
          "name": "Belgium",
          "value": 0.00122249388753056
        },
        {
          "category": "lithuania",
          "name": "Lithuania",
          "value": 0.00122249388753056
        },
        {
          "category": "jamaica",
          "name": "Jamaica",
          "value": 0.00122249388753056
        },
        {
          "category": "kazakhstan",
          "name": "Kazakhstan",
          "value": 0.00122249388753056
        },
        {
          "category": "afghanistan",
          "name": "Afghanistan",
          "value": 0.00122249388753056
        },
        {
          "category": "sri-lanka",
          "name": "Sri Lanka",
          "value": 0.00122249388753056
        },
        {
          "category": "bermuda",
          "name": "Bermuda",
          "value": 0.000814995925020375
        },
        {
          "category": "nepal",
          "name": "Nepal",
          "value": 0.000814995925020375
        },
        {
          "category": "czech-republic",
          "name": "Czech Republic",
          "value": 0.000814995925020375
        },
        {
          "category": "norway",
          "name": "Norway",
          "value": 0.000814995925020375
        },
        {
          "category": "bulgaria",
          "name": "Bulgaria",
          "value": 0.000814995925020375
        },
        {
          "category": "ghana",
          "name": "Ghana",
          "value": 0.000814995925020375
        },
        {
          "category": "qatar",
          "name": "Qatar",
          "value": 0.000814995925020375
        },
        {
          "category": "austria",
          "name": "Austria",
          "value": 0.000814995925020375
        },
        {
          "category": "zimbabwe",
          "name": "Zimbabwe",
          "value": 0.000814995925020375
        },
        {
          "category": "north-korea",
          "name": "North Korea",
          "value": 0.000814995925020375
        },
        {
          "category": "croatia",
          "name": "Croatia",
          "value": 0.000814995925020375
        },
        {
          "category": "armenia",
          "name": "Armenia",
          "value": 0.000407497962510187
        },
        {
          "category": "malta",
          "name": "Malta",
          "value": 0.000407497962510187
        },
        {
          "category": "bahrain",
          "name": "Bahrain",
          "value": 0.000407497962510187
        },
        {
          "category": "oman",
          "name": "Oman",
          "value": 0.000407497962510187
        },
        {
          "category": "panama",
          "name": "Panama",
          "value": 0.000407497962510187
        },
        {
          "category": "u-s-virgin-islands",
          "name": "U S Virgin Islands",
          "value": 0.000407497962510187
        },
        {
          "category": "estonia",
          "name": "Estonia",
          "value": 0.000407497962510187
        },
        {
          "category": "iceland",
          "name": "Iceland",
          "value": 0.000407497962510187
        },
        {
          "category": "tunisia",
          "name": "Tunisia",
          "value": 0.000407497962510187
        },
        {
          "category": "montenegro",
          "name": "Montenegro",
          "value": 0.000407497962510187
        },
        {
          "category": "israel",
          "name": "Israel",
          "value": 0.000407497962510187
        },
        {
          "category": "saudi-arabia",
          "name": "Saudi Arabia",
          "value": 0.000407497962510187
        },
        {
          "category": "china",
          "name": "China",
          "value": 0.000407497962510187
        },
        {
          "category": "slovenia",
          "name": "Slovenia",
          "value": 0.000407497962510187
        },
        {
          "category": "honduras",
          "name": "Honduras",
          "value": 0.000407497962510187
        },
        {
          "category": "moldova",
          "name": "Moldova",
          "value": 0.000407497962510187
        },
        {
          "category": "albania",
          "name": "Albania",
          "value": 0.000407497962510187
        },
        {
          "category": "georgia",
          "name": "Georgia",
          "value": 0.000407497962510187
        },
        {
          "category": "latvia",
          "name": "Latvia",
          "value": 0.000407497962510187
        },
        {
          "category": "norfolk-island",
          "name": "Norfolk Island",
          "value": 0.000407497962510187
        },
        {
          "category": "macedonia",
          "name": "Macedonia",
          "value": 0.000407497962510187
        },
        {
          "category": "chile",
          "name": "Chile",
          "value": 0.000407497962510187
        },
        {
          "category": "puerto-rico",
          "name": "Puerto Rico",
          "value": 0.000407497962510187
        },
        {
          "category": "maldives",
          "name": "Maldives",
          "value": 0.000407497962510187
        }
      ],
      "followersGendersAges": {
        "data": [
          {
            "category": "0_18",
            "male": 0.0364431486880466,
            "female": 0.0517492711370262
          },
          {
            "category": "18_21",
            "male": 0.0553935860058309,
            "female": 0.0575801749271137
          },
          {
            "category": "21_24",
            "male": 0.0495626822157434,
            "female": 0.0408163265306122
          },
          {
            "category": "24_27",
            "male": 0.129008746355685,
            "female": 0.0590379008746356
          },
          {
            "category": "27_30",
            "male": 0.126093294460641,
            "female": 0.0473760932944606
          },
          {
            "category": "30_35",
            "male": 0.123906705539359,
            "female": 0.0240524781341108
          },
          {
            "category": "35_45",
            "male": 0.115160349854227,
            "female": 0.0276967930029155
          },
          {
            "category": "45_100",
            "male": 0.043731778425656,
            "female": 0.0123906705539359
          }
        ],
        "summary": {
          "avgAges": "24_27",
          "male": 0.679300291545189,
          "female": 0.32069970845481
        }
      },
      "followersTypes": [
        {
          "name": "real",
          "percent": 0.60912419036891
        },
        {
          "name": "influencer",
          "percent": 0.372852717544354
        },
        {
          "name": "suspicious",
          "percent": 0.0160518163897494
        },
        {
          "name": "massfollowers",
          "percent": 0.00197127569698676
        }
      ],
      "followersReachability": [
        {
          "name": "r0_500",
          "percent": 0.47566765578635
        },
        {
          "name": "r1500_plus",
          "percent": 0.459050445103858
        },
        {
          "name": "r500_1000",
          "percent": 0.0376854599406528
        },
        {
          "name": "r1000_1500",
          "percent": 0.0275964391691395
        }
      ],
      "countries": [
        {
          "name": "united-states",
          "percent": 0.548492257538712
        },
        {
          "name": "united-kingdom",
          "percent": 0.0709046454767726
        },
        {
          "name": "india",
          "percent": 0.0546047269763651
        },
        {
          "name": "canada",
          "percent": 0.052159739201304
        }
      ],
      "cities": [
        {
          "name": "birmingham",
          "percent": 0.142857142857143
        },
        {
          "name": "long-beach",
          "percent": 0.0714285714285714
        },
        {
          "name": "dallas",
          "percent": 0.0714285714285714
        },
        {
          "name": "dubai",
          "percent": 0.0714285714285714
        },
        {
          "name": "perth",
          "percent": 0.0714285714285714
        }
      ],
      "genders": [
        {
          "name": "m",
          "percent": 0.679300291545189
        },
        {
          "name": "f",
          "percent": 0.32069970845481
        }
      ],
      "ages": [
        {
          "name": "24_27",
          "percent": 0.188046647230321
        },
        {
          "name": "27_30",
          "percent": 0.173469387755102
        },
        {
          "name": "30_35",
          "percent": 0.147959183673469
        },
        {
          "name": "35_45",
          "percent": 0.142857142857143
        },
        {
          "name": "18_21",
          "percent": 0.112973760932945
        },
        {
          "name": "21_24",
          "percent": 0.0903790087463557
        },
        {
          "name": "0_18",
          "percent": 0.0881924198250729
        },
        {
          "name": "45_100",
          "percent": 0.0561224489795918
        }
      ],
      "interests": []
    },
    "extra": {
      "categories": [
        "business-and-careers",
        "food-and-cooking",
        "lifestyle",
        "management-and-marketing",
        "modeling"
      ],
      "tags": [
        "bloggers",
        "celebrities",
        "blogger",
        "person",
        "english",
        "united-states",
        "business",
        "lifestyle",
        "travel",
        "food-and-cooking",
        "business-and-careers",
        "management-and-marketing",
        "modeling",
        "brands"
      ],
      "lastFromMentions": [],
      "profileSafety": {
        "ad": 0.0204081632653061,
        "not_marked_ad": 0,
        "alcohol": 0,
        "toxic": 0,
        "religious": 0,
        "negative": 0,
        "offensive": 0,
        "political": 0,
        "crime": 0,
        "adult": 0.0816326530612245,
        "pranks": 0,
        "totalScore": 0.00927643784786642
      },
      "connections": {
        "toMentions180d": 2,
        "toMentionsCommunities180d": 2,
        "toMentionsViews180d": 3424748,
        "fromMentions180d": 0,
        "fromMentionsCommunities180d": 0,
        "fromMentionsViews180d": 0,
        "pctUsersCount180d": 0.173184357541899,
        "contactEmail": "",
        "pctFakeFollowers": 0.0180230920867361
      }
    },
    "lastUpdatedISO": "2025-08-07T12:19:04.419Z",
    "lastUpdated": "07-08-2025"
  }
  ```
</ResponseExample>


## OpenAPI

````yaml api-reference/openapi-3.0.json get /wf/youtube-channel-demographic
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/youtube-channel-demographic:
    get:
      tags:
        - Workflow
      description: Triggers the workflow youtube-channel-demographic
      operationId: get_wf_youtube-channel-demographic
      parameters:
        - name: url
          in: query
          required: true
          description: >-
            Example: `https://www.youtube.com/@MrBeast` or
            `https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA`
          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

````