Skip to main content
GET
/
wf
/
tiktok-user-demographic
cURL
curl --request GET \
  --url https://riona.ai/api/1.1/wf/tiktok-user-demographic \
  --header 'Authorization: Bearer <token>'
{
  "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"
}
{
  "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"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

url
string
required

Profile url. Example: https://www.tiktok.com/@khaby.lame

api_key
string
required

This is your account API Key. You can easily locate it in your account dashboard.

Response

200

OK