Explore TikTok Posts

Browse TikTok by category rather than by account. Pass a category type and the endpoint returns the explore feed for that topic, with every video carrying its category marker, author, caption, sound and engagement counts. Count controls how many items come back, which makes it straightforward to keep a themed feed topped up on a schedule.

Try on Playground

PrimeApi Endpoints > Post (Video) Endpoints > Explore Posts

Endpoint Info

Request Method

GET

Request URL

https://api.primeapi.co/explore-posts?categoryType={categoryId}&count={count}

Required Parameters

categoryId

Optional Parameters

count

Request Examples

Request Flow

Explore Posts is a single GET call to /explore-posts, and categoryId has to travel with it in the query string. count 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 Explore 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/explore-posts?categoryType=119&count=16" \
  -H "X-PrimeAPI-Key: YOUR_API_KEY"

Python - Requests

import requests

url = "https://api.primeapi.co/explore-posts?categoryType=119&count=16"
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/explore-posts?categoryType=119&count=16

Content Type

JSON

Example Response

{
    "cursor": "0",
    "extra": {
        "fatal_item_ids": [],
        "logid": "20250117095113A76DDB15ED705D11176A",
        "now": 1737107474000
    },
    "hasMore": true,
    "itemList": [
        {
            "AIGCDescription": "",
            "CategoryType": 119,
            "author": {
                "avatarLarger": "https://p77-sign-va.tiktokcdn.com/tos-maliva-avt-0068/05050c22e4a2418a0c2646a95e74a2d7~c5_1080x1080.jpeg?lk3s=a5d48078&nonce=74191&refresh_token=8c8b04170ef56f1b3252ad1c58200732&x-expires=1737277200&x-signature=OsW3jIe7chinaRxLdAjtuowXmps%3D&shp=a5d48078&shcp=81f88b70",
                "avatarMedium": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/05050c22e4a2418a0c2646a95e74a2d7~c5_720x720.jpeg?lk3s=a5d48078&nonce=89810&refresh_token=76aa884d9948f68ff9aa3275b3d25a31&x-expires=1737277200&x-signature=yVYUg8Y1smIjCtbfpG3PIxn3Hq4%3D&shp=a5d48078&shcp=81f88b70",
                "avatarThumb": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/05050c22e4a2418a0c2646a95e74a2d7~c5_100x100.jpeg?lk3s=a5d48078&nonce=90115&refresh_token=78ebe1c3028bd791ff34587a07089490&x-expires=1737277200&x-signature=07r7vBl20YQntFrvk4DNivFl1jg%3D&shp=a5d48078&shcp=81f88b70",
                "commentSetting": 0,
                "downloadSetting": 0,
                "duetSetting": 0,
                "ftc": false,
                "id": "21488700",
                "isADVirtual": false,
                "isEmbedBanned": false,
                "nickname": "L",
                "openFavorite": false,
                "privateAccount": false,
                "relation": 0,
                "secUid": "MS4wLjABAAAA2K0HOudatyTLKwGt3NQY7tjB0bE_f2-ohl5G51I9gYQ",
                "secret": false,
                "signature": "\u2728\ud83d\udda4\n\nInstagram: @llaurasfreitas",
                "stitchSetting": 0,
                "uniqueId": "laurafreitas3",
                "verified": false
            },
            "authorStats": {
                "diggCount": 10300,
                "followerCount": 131900,
                "followingCount": 123,
                "friendCount": 0,
                "heart": 8000000,
                "heartCount": 8000000,
                "videoCount": 713
            },
            "backendSourceEventTracking": "",
            "collected": false,
            "createTime": 1736618369,
            "desc": "",
            "digged": false,
            "diversificationId": 10080,
            "duetDisplay": 0,
  ... (truncated)

Show full response

Related Endpoints

Explore TikTok Posts

More TikTok Post (Video) Endpoints