Get TikTok Related Posts

Ask TikTok what it considers similar to a given video. The endpoint takes a post ID and returns the clips the platform itself associates with it, each carrying its author, caption, sound and engagement counts. Because the ranking comes from TikTok rather than from a keyword match, it is a useful signal for recommendation features and for mapping out a topic cluster.

Try on Playground

PrimeApi Endpoints > Post (Video) Endpoints > Related Posts

Endpoint Info

Request Method

GET

Request URL

https://api.primeapi.co/related-posts?postId={postId}&count={count}&cursor={cursor}

Required Parameters

postId

Optional Parameters

count, cursor

Request Examples

Request Flow

Related Posts is a single GET call to /related-posts, and postId has to travel with it in the query string. count, cursor then shape what comes back. Swap YOUR_API_KEY for your own key and both snippets below run as they are.

Authentication

Header based. Send X-PrimeAPI-Key with every request — there is no OAuth handshake and no token to refresh.

Credits

One Related Posts call costs 1 credit. Your remaining balance comes back on every response in the X-PrimeAPI-Balance header, so you can watch usage without a second lookup.

cURL

curl -X GET "https://api.primeapi.co/related-posts?postId=7311302323228167429&count=30&cursor=0" \
  -H "X-PrimeAPI-Key: YOUR_API_KEY"

Python - Requests

import requests

url = "https://api.primeapi.co/related-posts?postId=7311302323228167429&count=30&cursor=0"
headers = {"X-PrimeAPI-Key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)

print(response.json())
print("Credits left:", response.headers.get("X-PrimeAPI-Balance"))

Endpoint Response

Example URL

https://api.primeapi.co/related-posts?postId=7311302323228167429&count=30&cursor=0

Content Type

JSON

Example Response

{
    "cursor": "-1",
    "extra": {
        "fatal_item_ids": [],
        "logid": "20250117094333E567848DF14BB81082BD",
        "now": 1737107015000
    },
    "itemList": [
        {
            "AIGCDescription": "",
            "CategoryType": 119,
            "author": {
                "avatarLarger": "https://p16-sign-sg.tiktokcdn.com/aweme/1080x1080/tos-alisg-avt-0068/1078781b5f78d5a4d6286d97c0f37300.jpeg?lk3s=a5d48078&nonce=84442&refresh_token=49eb493c318f5fbd64c4e61365a97c65&x-expires=1737277200&x-signature=T0xG%2BoxwoDUhtBaJCacJnFJwTwo%3D&shp=a5d48078&shcp=81f88b70",
                "avatarMedium": "https://p16-sign-sg.tiktokcdn.com/aweme/720x720/tos-alisg-avt-0068/1078781b5f78d5a4d6286d97c0f37300.jpeg?lk3s=a5d48078&nonce=55179&refresh_token=42195f8023b5498dec45b5005fea99f7&x-expires=1737277200&x-signature=Ldfpm8V1mBWVAiCM8JrTP%2BNia0U%3D&shp=a5d48078&shcp=81f88b70",
                "avatarThumb": "https://p16-sign-sg.tiktokcdn.com/aweme/100x100/tos-alisg-avt-0068/1078781b5f78d5a4d6286d97c0f37300.jpeg?lk3s=a5d48078&nonce=47749&refresh_token=162db7165201b611e50c0114e37e4101&x-expires=1737277200&x-signature=lMH6IN2Shll9OuGw%2Bw98ZUhfOXI%3D&shp=a5d48078&shcp=81f88b70",
                "commentSetting": 0,
                "downloadSetting": 0,
                "duetSetting": 0,
                "ftc": false,
                "id": "6993697109876147227",
                "isADVirtual": false,
                "isEmbedBanned": false,
                "nickname": "Thuc Uy\u00ean \ud83d\udc3c\ud83e\udee7",
                "openFavorite": false,
                "privateAccount": false,
                "relation": 0,
                "secUid": "MS4wLjABAAAA2pmLADn3A8bxuJONAiJGGaws5x8GWB3L01VwXps_Aw1MmQlPICOqFOkc2lQrH5iZ",
                "secret": false,
                "signature": "Ko \u0111\u1eb9p \u0111\u1eebng khen \nIG : tt_uyen_sus\n\ud83d\uded2 \ud83d\udc47\ud83c\udffb nhen",
                "stitchSetting": 0,
                "uniqueId": "tt_uyen_1211",
                "verified": false
            },
            "authorStats": {
                "diggCount": 10800,
                "followerCount": 116900,
                "followingCount": 8,
                "friendCount": 0,
                "heart": 1100000,
                "heartCount": 1100000,
                "videoCount": 133
            },
            "backendSourceEventTracking": "yml_36",
            "challenges": [
                {
                    "coverLarger": "",
  ... (truncated)

Show full response

Related Endpoints

Get TikTok Related Posts

More TikTok Post (Video) Endpoints