Skip to main content
GET
/
wf
/
universal-profile-posts
cURL
curl --request GET \
  --url https://riona.ai/api/1.1/wf/universal-profile-posts \
  --header 'Authorization: Bearer <token>'
{
    "status": {
    "code": 200,
    "message": "OK"
	},

"about": {
"type": "posts",
"period": "Aug 2025"
},
"posts": [

{
  "postDetails": {
        "postID": "7535822781108194582",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_TT:127905465618821121_7535822781108194582?time=1760016121",
        "videoLink": "https://v16-webapp-prime.tiktok.com/video/tos/no1a/tos-no1a-ve-0068c001-no/oIolenxnIqJKBaOEQEIUEFAngRFwIkfspgSD7E/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2822&bt=1411&cs=0&ds=3&ft=-Csk_mgdPD12NACEwh-Ux7N2hY3W3wv25BcAp&mime_type=video_mp4&qs=0&rc=PDw1Zzw2aWY7NDs2ZDg5NEBpanI3b205cms8NTMzbzczNUAuXzMwLmFeXi4xNC1iLjZgYSNmbmVnMmQ0cV5hLS1kMTFzcw%3D%3D&btag=e000b8000&expire=1760188945&l=20251009132200EF2F52587F9646227AD2&ply_type=2&policy=2&signature=3bd178c95569874d9e2a2c08017e17ca&tk=tt_chain_token",
        "postUrl": "https://www.tiktok.com/@khaby.lame/video/7535822781108194582",
        "dataId": "127905465618821121_7535822781108194582",
        "date": "07-08-2025",
        "dateISO": "2025-08-07T12:41:12.000Z",
        "likes": 375800,
        "dislikes": 0,
        "comments": 7522,
        "rePosts": 6484,
        "views": 8200000,
        "pollVotes": 0,
        "videoViews": 8200000,
        "type": "video",
        "types": [
          "video"
        ],
        "hashTags": [
         "learnfromkhaby","comedy"
        ],
        "text": "Nothing personal 🚶🏿🫶🏾#learnfromkhaby #comedy ",
        "textLength": 49,
        "fromOwner": false,
        "isAd": false,
        "mentions": [

],
        "mentionsText": [

]
},
  "postStats": {
        "interactions": 389806,
        "er": 0.00241067408781694,
        "viewsER": 0.0475373170731707,
        "videoViewsER": 0.0475373170731707,
        "indexGrade": -2.18230284655743,
        "mainGrade": "d"
 }
},{
  "postDetails": {
        "postID": "7538431890357865750",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_TT:127905465618821121_7538431890357865750?time=1760016121",
        "videoLink": "https://v16-webapp-prime.tiktok.com/video/tos/no1a/tos-no1a-ve-0068c001-no/oYZBYFadADV7FaxtBCiBdJ7jIQQS53lEEPiWw/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=1788&bt=894&cs=0&ds=3&ft=-Csk_mgdPD12NACEwh-Ux7N2hY3W3wv25BcAp&mime_type=video_mp4&qs=0&rc=PDc6aDY0ZTc0Z2Y8OjhpNUBpanVvb2s5cmp4NTMzbzczNUAuX2NgMl9fX18xMDI2YV9iYSMuLmBqMmQ0NGJhLS1kMTFzcw%3D%3D&btag=e00088000&expire=1760188966&l=20251009132200EF2F52587F9646227AD2&ply_type=2&policy=2&signature=df5135eeec0cfc65bd548e3d4e1efeb1&tk=tt_chain_token",
        "postUrl": "https://www.tiktok.com/@khaby.lame/video/7538431890357865750",
        "dataId": "127905465618821121_7538431890357865750",
        "date": "14-08-2025",
        "dateISO": "2025-08-14T13:25:53.000Z",
        "likes": 528000,
        "dislikes": 0,
        "comments": 14100,
        "rePosts": 12900,
        "views": 15200000,
        "pollVotes": 0,
        "videoViews": 15200000,
        "type": "video",
        "types": [
          "video"
        ],
        "hashTags": [
         "learnfromkhaby","commedy"
        ],
        "text": "👌🏾 perfect #learnfromkhaby #commedy ",
        "textLength": 38,
        "fromOwner": false,
        "isAd": false,
        "mentions": [

],
        "mentionsText": [

]
},
  "postStats": {
        "interactions": 555000,
        "er": 0.00343228200371058,
        "viewsER": 0.0365131578947368,
        "videoViewsER": 0.0365131578947368,
        "indexGrade": -1.39154817185109,
        "mainGrade": "c"
 }
}
     
        ]
}
Supported Platforms: 
{
    "status": {
    "code": 200,
    "message": "OK"
	},

"about": {
"type": "posts",
"period": "Aug 2025"
},
"posts": [

{
  "postDetails": {
        "postID": "7535822781108194582",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_TT:127905465618821121_7535822781108194582?time=1760016121",
        "videoLink": "https://v16-webapp-prime.tiktok.com/video/tos/no1a/tos-no1a-ve-0068c001-no/oIolenxnIqJKBaOEQEIUEFAngRFwIkfspgSD7E/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2822&bt=1411&cs=0&ds=3&ft=-Csk_mgdPD12NACEwh-Ux7N2hY3W3wv25BcAp&mime_type=video_mp4&qs=0&rc=PDw1Zzw2aWY7NDs2ZDg5NEBpanI3b205cms8NTMzbzczNUAuXzMwLmFeXi4xNC1iLjZgYSNmbmVnMmQ0cV5hLS1kMTFzcw%3D%3D&btag=e000b8000&expire=1760188945&l=20251009132200EF2F52587F9646227AD2&ply_type=2&policy=2&signature=3bd178c95569874d9e2a2c08017e17ca&tk=tt_chain_token",
        "postUrl": "https://www.tiktok.com/@khaby.lame/video/7535822781108194582",
        "dataId": "127905465618821121_7535822781108194582",
        "date": "07-08-2025",
        "dateISO": "2025-08-07T12:41:12.000Z",
        "likes": 375800,
        "dislikes": 0,
        "comments": 7522,
        "rePosts": 6484,
        "views": 8200000,
        "pollVotes": 0,
        "videoViews": 8200000,
        "type": "video",
        "types": [
          "video"
        ],
        "hashTags": [
         "learnfromkhaby","comedy"
        ],
        "text": "Nothing personal 🚶🏿🫶🏾#learnfromkhaby #comedy ",
        "textLength": 49,
        "fromOwner": false,
        "isAd": false,
        "mentions": [

],
        "mentionsText": [

]
},
  "postStats": {
        "interactions": 389806,
        "er": 0.00241067408781694,
        "viewsER": 0.0475373170731707,
        "videoViewsER": 0.0475373170731707,
        "indexGrade": -2.18230284655743,
        "mainGrade": "d"
 }
},{
  "postDetails": {
        "postID": "7538431890357865750",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_TT:127905465618821121_7538431890357865750?time=1760016121",
        "videoLink": "https://v16-webapp-prime.tiktok.com/video/tos/no1a/tos-no1a-ve-0068c001-no/oYZBYFadADV7FaxtBCiBdJ7jIQQS53lEEPiWw/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=1788&bt=894&cs=0&ds=3&ft=-Csk_mgdPD12NACEwh-Ux7N2hY3W3wv25BcAp&mime_type=video_mp4&qs=0&rc=PDc6aDY0ZTc0Z2Y8OjhpNUBpanVvb2s5cmp4NTMzbzczNUAuX2NgMl9fX18xMDI2YV9iYSMuLmBqMmQ0NGJhLS1kMTFzcw%3D%3D&btag=e00088000&expire=1760188966&l=20251009132200EF2F52587F9646227AD2&ply_type=2&policy=2&signature=df5135eeec0cfc65bd548e3d4e1efeb1&tk=tt_chain_token",
        "postUrl": "https://www.tiktok.com/@khaby.lame/video/7538431890357865750",
        "dataId": "127905465618821121_7538431890357865750",
        "date": "14-08-2025",
        "dateISO": "2025-08-14T13:25:53.000Z",
        "likes": 528000,
        "dislikes": 0,
        "comments": 14100,
        "rePosts": 12900,
        "views": 15200000,
        "pollVotes": 0,
        "videoViews": 15200000,
        "type": "video",
        "types": [
          "video"
        ],
        "hashTags": [
         "learnfromkhaby","commedy"
        ],
        "text": "👌🏾 perfect #learnfromkhaby #commedy ",
        "textLength": 38,
        "fromOwner": false,
        "isAd": false,
        "mentions": [

],
        "mentionsText": [

]
},
  "postStats": {
        "interactions": 555000,
        "er": 0.00343228200371058,
        "viewsER": 0.0365131578947368,
        "videoViewsER": 0.0365131578947368,
        "indexGrade": -1.39154817185109,
        "mainGrade": "c"
 }
}
     
        ]
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
id
string
required

masterID: the id of the Social Account, to get this you need to call the endpoint Get Profile by URL

​
month
string
default:2025/08/30
required
  • Date Format: yyyy-mm-dd
  • Specify the month you want to retrieve.
  • Posts are collected within a one-month period.
  • Enter the first date of the month you want to collect.
  • To collect posts up to yesterday, enter the first date of the current month.
  • The more posts a month contains, the longer it will take to return the data.
​
includeProfile
boolean
default:false

If you would like to include Profile details, set this to true

​
type
string
default:posts
required

Default: posts posts will show all feeds and content types.

Possible options: posts stories REELS video photo

  • posts, video, photo : All Platforms
  • stories, REELS : Instagram
​
api_key
string
required

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

Response

200

OK