> ## 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 twitter / X Demographic Data of a Profile

<ResponseExample>
  ```json 200 theme={null}
  {
    "status": {
      "code": 200,
      "message": "OK"
    },
    "demographic": {
      "followersCities": [
        {
          "category": "washington-dc",
          "name": "Washington, D.C.",
          "value": 0.333333333333333
        },
        {
          "category": "accra",
          "name": "Accra",
          "value": 0.333333333333333
        },
        {
          "category": "sao-paulo",
          "name": "Sao Paulo",
          "value": 0.333333333333333
        }
      ],
      "followersCountries": [
        {
          "category": "united-states",
          "name": "United States",
          "value": 0.6
        },
        {
          "category": "ghana",
          "name": "Ghana",
          "value": 0.2
        },
        {
          "category": "brazil",
          "name": "Brazil",
          "value": 0.2
        }
      ],
      "followersGendersAges": {
        "data": [
          {
            "category": "0_18",
            "male": 0.0333333333333333,
            "female": 0.0666666666666667
          },
          {
            "category": "18_21",
            "male": 0,
            "female": 0.0166666666666667
          },
          {
            "category": "21_24",
            "male": 0.0333333333333333,
            "female": 0.0333333333333333
          },
          {
            "category": "24_27",
            "male": 0.05,
            "female": 0.05
          },
          {
            "category": "27_30",
            "male": 0.05,
            "female": 0.05
          },
          {
            "category": "30_35",
            "male": 0.116666666666667,
            "female": 0.133333333333333
          },
          {
            "category": "35_45",
            "male": 0.2,
            "female": 0.0833333333333333
          },
          {
            "category": "45_100",
            "male": 0.0666666666666667,
            "female": 0.0166666666666667
          }
        ],
        "summary": {
          "avgAges": "35_45",
          "male": 0.55,
          "female": 0.45
        }
      },
      "followersTypes": [
        {
          "name": "real",
          "percent": 0
        },
        {
          "name": "influencer",
          "percent": 0
        },
        {
          "name": "massfollowers",
          "percent": 0
        },
        {
          "name": "suspicious",
          "percent": 0
        }
      ],
      "followersReachability": [
        {
          "name": "r0_500",
          "percent": 0
        },
        {
          "name": "r500_1000",
          "percent": 0
        },
        {
          "name": "r1000_1500",
          "percent": 0
        },
        {
          "name": "r1500_plus",
          "percent": 0
        }
      ],
      "countries": [
        {
          "name": "united-states",
          "percent": 0.6
        },
        {
          "name": "ghana",
          "percent": 0.2
        },
        {
          "name": "brazil",
          "percent": 0.2
        }
      ],
      "cities": [
        {
          "name": "washington-dc",
          "percent": 0.333333333333333
        },
        {
          "name": "accra",
          "percent": 0.333333333333333
        },
        {
          "name": "sao-paulo",
          "percent": 0.333333333333333
        }
      ],
      "genders": [
        {
          "name": "m",
          "percent": 0.55
        },
        {
          "name": "f",
          "percent": 0.45
        }
      ],
      "ages": [
        {
          "name": "35_45",
          "percent": 0.283333333333333
        },
        {
          "name": "30_35",
          "percent": 0.25
        },
        {
          "name": "0_18",
          "percent": 0.1
        },
        {
          "name": "24_27",
          "percent": 0.1
        },
        {
          "name": "27_30",
          "percent": 0.1
        },
        {
          "name": "45_100",
          "percent": 0.0833333333333333
        },
        {
          "name": "21_24",
          "percent": 0.0666666666666667
        },
        {
          "name": "18_21",
          "percent": 0.0166666666666667
        }
      ],
      "interests": []
    },
    "extra": {
      "categories": [
        "business-and-careers",
        "management-and-marketing",
        "news-and-media"
      ],
      "tags": [
        "australia",
        "celebrities",
        "english",
        "influencer",
        "gender-m",
        "age-45_100",
        "politics",
        "news-and-media",
        "government",
        "management-and-marketing",
        "business-and-careers",
        "society"
      ],
      "lastFromMentions": [
        {
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:1389913567671975937?time=1744502493",
          "url": "https://twitter.com/cb_doge",
          "name": "DogeDesigner"
        },
        {
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:11348282?time=1754129599",
          "url": "https://twitter.com/NASA",
          "name": "NASA"
        },
        {
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:1451773004?time=1723920060",
          "url": "https://twitter.com/Space_Station",
          "name": "International Space Station"
        },
        {
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:16580226?time=1723534416",
          "url": "https://twitter.com/NASAKennedy",
          "name": "NASA's Kennedy Space Center"
        },
        {
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:34743251?time=1754130011",
          "url": "https://twitter.com/SpaceX",
          "name": "SpaceX"
        },
        {
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:1330170106501079041?time=1732874693",
          "url": "https://twitter.com/Starlink",
          "name": "Starlink"
        },
        {
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:13298072?time=1748718676",
          "url": "https://twitter.com/Tesla",
          "name": "Tesla"
        },
        {
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:30699048?time=1726530330",
          "url": "https://twitter.com/BillyM2k",
          "name": "Shibetoshi Nakamoto"
        },
        {
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:243013409?time=1720300647",
          "url": "https://twitter.com/SawyerMerritt",
          "name": "Sawyer Merritt"
        },
        {
          "image": "https://6f2859a7-8667-4b05-9978-a8922e29bf1f.selstorage.ru/TW:1319287761048723458?time=1734774203",
          "url": "https://twitter.com/MarioNawfal",
          "name": "Mario Nawfal"
        }
      ],
      "profileSafety": {
        "ad": 0.0016902088615236,
        "not_marked_ad": 1,
        "alcohol": 0,
        "toxic": 0,
        "religious": 0,
        "negative": 0,
        "offensive": 0,
        "political": 0,
        "crime": 0,
        "adult": 0.000603646021972715,
        "pranks": 0,
        "totalScore": 0.0911176231712269
      },
      "connections": {
        "toMentions180d": 824,
        "toMentionsCommunities180d": 225,
        "toMentionsViews180d": 568175846,
        "fromMentions180d": 1800,
        "fromMentionsCommunities180d": 155,
        "fromMentionsViews180d": 3940049778,
        "pctUsersCount180d": 0.0361368515682078,
        "contactEmail": "",
        "pctFakeFollowers": 0
      }
    },
    "lastUpdatedISO": "2025-08-03T07:05:44.564Z",
    "lastUpdated": "03-08-2025"
  }
  ```
</ResponseExample>


## OpenAPI

````yaml api-reference/openapi-3.0.json get /wf/twitter-user-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/twitter-user-demographic:
    get:
      tags:
        - Workflow
      description: Triggers the workflow twitter-user-demographic
      operationId: get_wf_twitter-user-demographic
      parameters:
        - name: url
          in: query
          required: true
          description: >-
            Profile url. Example: `https://x.com/NoCapMediaa` or
            `https://twitter.com/NoCapMediaa`
          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

````