TikTok User Posts API

List the videos and photo posts on a public TikTok account by username. Each post includes the caption, view, like, comment, share and save counts, sound, hashtags and cover image. Page through results with the `cursor` from the previous response's `nextCursor`.

Endpoint: POST /tiktok/get-user-posts
Price: 1 credit per result
SDK: client.tiktok.getUserPosts()
MCP tool: tiktok_get_user_posts

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/tiktok/get-user-posts" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "uniqueId": "tiktok",
  "count": 10
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/tiktok/get-user-posts",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "uniqueId": "tiktok",
        "count": 10,
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/tiktok/get-user-posts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "uniqueId": "tiktok",
    "count": 10
  }),
});
const data = await response.json();

request.ts

import { Bridgly } from "@bridgly/sdk";
const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });
const res = await client.tiktok.getUserPosts({
  uniqueId: "tiktok",
  count: 10
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the TikTok User Posts API return?

TikTok posts API: list any public account’s videos and photo posts by username, with caption, views, likes, comments, shares, sound and hashtags, as JSON. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

cursorstring: The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.
uniqueIdstringrequired: TikTok username, with or without @, or the profile link, for example "tiktok" or "https://www.tiktok.com/@tiktok".
countinteger · 1–35 · default 35: Number of results to return (1–35). Defaults to 35.

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "nextCursor": "string",
    "videos": [
      {
        "id": "string",
        "url": "string",
        "description": "string",
        "createTime": 0,
        "language": "string",
        "duration": 0,
        "width": 0,
        "height": 0,
        "coverUrl": "string",
        "animatedCoverUrl": "string",
        "images": [
          "string"
        ],
        "subtitles": [
          {
            "language": "string",
            "format": "string",
            "autoGenerated": true,
            "url": "string"
          }
        ],
        "stats": {
          "playCount": 0,
          "likeCount": 0,
          "commentCount": 0,
          "shareCount": 0,
          "saveCount": 0,
          "repostCount": 0
        },
        "author": {
          "id": "string",
          "uniqueId": "string",
          "nickname": "string",
          "avatarUrl": "string",
          "signature": "string",
          "verified": true,
          "secUid": "string",
          "privateAccount": true,
          "followerCount": 0,
          "followingCount": 0,
          "heartCount": 0,
          "videoCount": 0
        },
        "sound": {
          "id": "string",
          "title": "string",
          "authorName": "string",
          "original": true,
          "duration": 0,
          "coverUrl": "string",
          "playUrl": "string",
          "album": "string",
          "copyrighted": true,
          "videoCount": 0
        },
        "hashtags": [
          "string"
        ],
        "mentions": [
          "string"
        ],
        "location": {
          "id": "string",
          "name": "string",
          "address": "string",
          "city": "string",
          "category": "string"
        },
        "playlistId": "string",
        "isAd": true,
        "duetEnabled": true,
        "stitchEnabled": true
      }
    ]
  }
}

[ USE CASES ]

What can you build with the TikTok User Posts API?

Measure engagement

Work out average views and likes per video for a creator.

Monitor competitors

See what brands and rival creators post each week.

Archive content

Keep captions, hashtags and cover images of the posts you track.

[ FAQ ]

TikTok User Posts API questions

How do I get all videos from a TikTok account?

Send the username and page through the results with the nextCursor from each response. nextCursor is null once there are no more posts.

Does it include photo posts?

Yes. Photo posts are returned alongside videos, with their image links in images.

How do I use the TikTok User Posts API?

Send a POST request to https://api.bridgly.app/tiktok/get-user-posts with uniqueId in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.tiktok.getUserPosts(). AI agents connected to Bridgly over MCP can call the tiktok_get_user_posts tool.

How much does the TikTok User Posts API cost?

Costs 1 credit per result returned, with a minimum of 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

[ MORE ENDPOINTS ]

More TikTok endpoints

The same API key works on every endpoint. See all TikTok API endpoints.

Try the TikTok User Posts API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI

free credits

On business email signup. No credit card required.

Start free with 100 credits

Book a demo Read the docs