Get TikTok Post Detail

Read one TikTok video in full. Supply the post ID and the endpoint returns its item record: the caption, cover and play addresses, duration, the sound attached to it, the author block and the play, like, comment, share and save counts, plus the upload timestamp. It is the detail call behind a video page and the natural follow-up to any feed or search result.

Try on Playground

PrimeApi Endpoints > Post (Video) Endpoints > Post Detail

Endpoint Info

Request Method

GET

Request URL

https://api.primeapi.co/post-detail?postId={postId}

Required Parameters

postId

Request Examples

Request Flow

Post Detail is a single GET call to /post-detail, and postId has to travel with it in the query string. 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 Post Detail 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/post-detail?postId=7330315169584778539" \
  -H "X-PrimeAPI-Key: YOUR_API_KEY"

Python - Requests

import requests

url = "https://api.primeapi.co/post-detail?postId=7330315169584778539"
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/post-detail?postId=7330315169584778539

Content Type

JSON

Example Response

{
    "itemInfo": {
        "itemStruct": {
            "id": "7330315169584778539",
            "desc": "There is no better feeling than being able to reunite a family \ud83d\ude2d\u2764\ufe0f ICYMI: I trapped 4 older kittens (about 8 months old) a couple of weeks ago, but their mom kept evading the trap. Finally, last night, we were able to get her and the second I put her in with her kittens, they glued themselves to her. I always worry that mama cats think something happened to their kittens when I catch them first, so I\u2019m so relieved I was able to show her that they\u2019re all okay. Mama Mocha is the brown cat all the way in the back of the tub, Cafe Au Lait is black & white, Macchiato is the lynx point siamese, Caramella is the longhair seal point siamese, and Java is the maine coon mix. Such a stunning litter and proof that you can find just about any type of cat in rescues \u2764\ufe0f #fyp #foryou #fy #fosterkittens ",
            "createTime": "1706722070",
            "scheduleTime": 0,
            "video": {
                "id": "",
                "height": 1024,
                "width": 576,
                "duration": 18,
                "ratio": "540p",
                "cover": "https://p19-sign.tiktokcdn-us.com/obj/tos-useast5-p-0068-tx/o8F6ym6h5UvEPbViqlxjZi4gBBIZgipCzBXAE?lk3s=81f88b70&x-expires=1737248400&x-signature=0Y0jU5v6H9ttNnCr9vBpESDTHMw%3D&shp=81f88b70&shcp=-",
                "originCover": "https://p16-sign.tiktokcdn-us.com/obj/tos-useast5-p-0068-tx/3af30fe989b1426ca8129075dbf4e3b5_1706722072?lk3s=81f88b70&x-expires=1737248400&x-signature=ii0s%2BnhnwBmc90yINvzyCifNPD4%3D&shp=81f88b70&shcp=-",
                "dynamicCover": "https://p16-sign.tiktokcdn-us.com/obj/tos-useast5-p-0068-tx/5d2a4d2c19954660a4449a85dede3c6a_1706722072?lk3s=81f88b70&x-expires=1737248400&x-signature=2IiFSHyDdTfB8PphDLcbb84a%2FDs%3D&shp=81f88b70&shcp=-",
                "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/maliva/tos-maliva-ve-0068c799-us/oM6hbvC0jpZAi6WBpIgQZBzEUl7E4PnBigisq/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=1722&bt=861&cs=0&ds=6&ft=-Csk_mgdPD12NEv~dE-UxJ42SY3W3wv25BcAp&mime_type=video_mp4&qs=0&rc=OWUzZmc4OTQzM2Y7NDxkM0BpajU5c3Q5cmk7cDMzZzczNEBgMDI2LzA1NjExMDM1NjFgYSNlMGFgMmRrMXFgLS1kMS9zcw%3D%3D&btag=e000b8000&expire=1737249715&l=20250117012137A318D5A0F5D4E918A419&ply_type=2&policy=2&signature=1c71b9cd66d06f9fbea4e1cd4dc4d38a&tk=tt_chain_token",
  ... (truncated)

Show full response

Guides

How to use Post Detail

How to Get TikTok Video Data via API

Read all TikTok API guides

Related Endpoints

Get TikTok Post Detail

How to use Post Detail

More TikTok Post (Video) Endpoints