Skip to main content

​
Working with Cursor with TikTok API for Pagination

TikTok’s API uses a cursor-based pagination system to handle large datasets.
Each response includes a cursor value that indicates where to continue retrieving the next set of data.

What is a Tiktok Cursor?

A Tiktok Cursor is a token returned by TikTok API that points to the next page of results.

​
1. Initial Request

Make an initial API request to retrieve the first page of data. The cursor value will be set to 0 by default on the first request. The response will typically include a list of results and a cursor field for the next page.

​
Example API request to Get User Posts

import requests

url = "https://tiktok-api23.p.rapidapi.com/api/user/posts"

params = {
  "secUid":"MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6",
  "count":"35",
  "cursor":"0"
}

headers = {
	"x-rapidapi-key": "YOUR-X-RAPIDAPI-KEY",
	"x-rapidapi-host": "tiktok-api23.p.rapidapi.com"
}

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

print(response.json())
TikTok will return
  • itemList: list of posts
  • cursor: pointer for the next request
  • hasMore: whether more pages exist
Example response 
{
  "data": {
    "cursor": "1729260489000",
    "extra": {
      "fatal_item_ids": [],
      "logid": "2025021310472335DA5E9DB25F2C2A587A",
      "now": 1739414843000
    },
    "hasMore": true,
    "itemList": [...],
    "log_pb": {
      "impr_id": "2025021310472335DA5E9DB25F2C2A587A"
    },
    "statusCode": 0,
    "status_code": 0,
    "status_msg": ""
  }
}

​
2. Paginate with Cursor

To retrieve the next page of results, make another API request, but this time include the cursor parameter from the previous response. 
params = {
  "secUid":"MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6",
  "count":"35",
  "cursor":"1729260489000"
}

​
3. Repeat

Continue making requests using the new cursor value from each response to paginate through all available data. Each response will provide a new cursor value for the subsequent request.

​
4. End of Results

When the response no longer contains a cursor field or it is null/empty/-1, that means you’ve reached the end of the data and there are no more results to fetch.

​
Full Working Python Example


import requests

X_RAPIDAPI_KEY = 'YOUR-X-RAPIDAPI-KEY'
USER_SEC_UID = 'MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6'

def get_tiktok_user_posts(user_sec_uid, count=35, cursor='0'):
  url = "https://tiktok-api23.p.rapidapi.com/api/user/posts"

  params = {
    "secUid": user_sec_uid,
    "count": count,
    "cursor": cursor
  }

  headers = {
    "x-rapidapi-key": X_RAPIDAPI_KEY,
    "x-rapidapi-host": "tiktok-api23.p.rapidapi.com"
  }

  response = requests.get(url, headers=headers, params=params)
  data = response.json()

  posts = data.get('data', {}).get('itemList', [])
  cursor = data.get('data', {}).get('cursor', None)

  if cursor == '-1':
    cursor = None
  
  return posts, cursor


def fetch_all_user_posts(user_sec_uid, count=35):
  all_posts = []
  cursor = '0'  # Initial cursor

  while cursor is not None:
    posts, cursor = get_tiktok_user_posts(user_sec_uid, count, cursor)
    all_posts.extend(posts)

  return all_posts


# Example usage
posts = fetch_all_user_posts(USER_SEC_UID)
print(f"Fetched {len(posts)} posts.")
Need help? Check our support page or contact our team.