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"
}
Get user demographic data, categories, tags, safety analysis and more.
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"
}
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Profile url. Example: https://www.tiktok.com/@khaby.lame
This is your account API Key. You can easily locate it in your account dashboard.
OK