Skip to main content
GET
/
wf
/
tiktok-video-details
cURL
curl --request GET \
  --url https://riona.ai/api/1.1/wf/tiktok-video-details \
  --header 'Authorization: Bearer <token>'
{
  "status": {
    "code": 200,
    "message": "OK"
  },
  "post": [
    {
      "postDetails": {
        "postID": "7501786655280336150",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_TT:127905465618821121_7501786655280336150?time=1755644549",
        "videoLink": "https://v16-webapp-prime.tiktok.com/video/tos/no1a/tos-no1a-ve-0068-no/oAEGQNQn13l2IDFmamWLgeuAIUI0beDImAeLjs/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2686&bt=1343&cs=0&ds=3&ft=-Csk_mwKPD12N458sh-UxDTvSY3W3wv25dcAp&mime_type=video_mp4&qs=0&rc=NzRmNTZoM2lpaTlnZWU8ZEBpanhxdHM5cm51MzMzbzczNUAtLjJiLy9iXzQxX2AzY19gYSMvcmFwMmRrMmFhLS1kMTFzcw%3D%3D&btag=e000b8000&expire=1755817367&l=2025081923022547F8C90B9FD5118FCE67&ply_type=2&policy=2&signature=809aa709de2d0a6644d7120b8329e796&tk=tt_chain_token",
        "postUrl": "https://www.tiktok.com/@khaby.lame/video/7501786655280336150",
        "dataId": "127905465618821121_7501786655280336150",
        "date": "07-05-2025",
        "dateISO": "2025-05-07T19:23:39.000Z",
        "likes": 606900,
        "dislikes": 0,
        "comments": 9544,
        "rePosts": 4099,
        "views": 8300000,
        "pollVotes": 0,
        "videoViews": 8300000,
        "type": "video",
        "types": [
          "video"
        ],
        "hashTags": [
          "beyourownboss"
        ],
        "text": "Arriving in style at the Met Gala with BOSS #beyourownboss ",
        "textLength": 59,
        "fromOwner": false,
        "isAd": false,
        "mentions": [],
        "mentionsText": []
      },
      "postStats": {
        "interactions": 620543,
        "er": 0.00381872615384615,
        "viewsER": 0.0747642168674699,
        "videoViewsER": 0.0747642168674699,
        "indexGrade": -1.6695023860052,
        "mainGrade": "d"
      }
    }
  ]
}
General Instructions:
  • The id masterID is required to get access to that Social Account posts.
  • At least one should be used: postID or postURL
  • Make sure you run Get Posts & Videos endpoint at least one time for the month the post was published in before using this endpoint.
  • Understanding Post Data Handling
  • You can check what months already being tracked first Check Tracked Posts
{
  "status": {
    "code": 200,
    "message": "OK"
  },
  "post": [
    {
      "postDetails": {
        "postID": "7501786655280336150",
        "postImage": "https://8cd4d13f-aa75-4a0c-abdb-0f388a983964.selstorage.ru/post_TT:127905465618821121_7501786655280336150?time=1755644549",
        "videoLink": "https://v16-webapp-prime.tiktok.com/video/tos/no1a/tos-no1a-ve-0068-no/oAEGQNQn13l2IDFmamWLgeuAIUI0beDImAeLjs/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2686&bt=1343&cs=0&ds=3&ft=-Csk_mwKPD12N458sh-UxDTvSY3W3wv25dcAp&mime_type=video_mp4&qs=0&rc=NzRmNTZoM2lpaTlnZWU8ZEBpanhxdHM5cm51MzMzbzczNUAtLjJiLy9iXzQxX2AzY19gYSMvcmFwMmRrMmFhLS1kMTFzcw%3D%3D&btag=e000b8000&expire=1755817367&l=2025081923022547F8C90B9FD5118FCE67&ply_type=2&policy=2&signature=809aa709de2d0a6644d7120b8329e796&tk=tt_chain_token",
        "postUrl": "https://www.tiktok.com/@khaby.lame/video/7501786655280336150",
        "dataId": "127905465618821121_7501786655280336150",
        "date": "07-05-2025",
        "dateISO": "2025-05-07T19:23:39.000Z",
        "likes": 606900,
        "dislikes": 0,
        "comments": 9544,
        "rePosts": 4099,
        "views": 8300000,
        "pollVotes": 0,
        "videoViews": 8300000,
        "type": "video",
        "types": [
          "video"
        ],
        "hashTags": [
          "beyourownboss"
        ],
        "text": "Arriving in style at the Met Gala with BOSS #beyourownboss ",
        "textLength": 59,
        "fromOwner": false,
        "isAd": false,
        "mentions": [],
        "mentionsText": []
      },
      "postStats": {
        "interactions": 620543,
        "er": 0.00381872615384615,
        "viewsER": 0.0747642168674699,
        "videoViewsER": 0.0747642168674699,
        "indexGrade": -1.6695023860052,
        "mainGrade": "d"
      }
    }
  ]
}

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 OR Get User Details

includeProfile
boolean
default:false

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

postID
string

Example: postID: 7501786655280336150 , To get this use this endpoint: Get User Videos

postURL
string

Example: postURL: https://www.tiktok.com/@khaby.lame/video/7501786655280336150 , To get this use this endpoint: Get User Videos

api_key
string
required

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

Response

200

OK