Get Posts & Videos

cURL

curl --request GET \
  --url https://riona.ai/api/1.1/wf/universal-profile-posts \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://riona.ai/api/1.1/wf/universal-profile-posts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://riona.ai/api/1.1/wf/universal-profile-posts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://riona.ai/api/1.1/wf/universal-profile-posts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://riona.ai/api/1.1/wf/universal-profile-posts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
    "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"
 }
}
     
        ]
}

GET

universal-profile-posts

cURL

curl --request GET \
  --url https://riona.ai/api/1.1/wf/universal-profile-posts \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://riona.ai/api/1.1/wf/universal-profile-posts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://riona.ai/api/1.1/wf/universal-profile-posts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://riona.ai/api/1.1/wf/universal-profile-posts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://riona.ai/api/1.1/wf/universal-profile-posts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
    "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

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

API documentation

Account API

Data API

Social Media API

Authorizations

Query Parameters

Response