Definition
max_cursor is the pagination parameter used by TikTok's user posts endpoint, where each response includes a max_cursor value to fetch the next page of results. It differs from numeric offset pagination used by search and comment endpoints.
In Depth
TikTok API uses three distinct pagination patterns, and max_cursor is specific to the user/posts endpoint. When you request a user's videos, the response includes has_more (boolean) and max_cursor (a timestamp-like value). Pass max_cursor in the next request to get the next page. This is different from search and comment endpoints which use numeric cursor offsets, and follower/following endpoints which use page_token+min_time. Scavio's TikTok user/posts endpoint follows this pattern: first request omits max_cursor, subsequent requests include it from the previous response. Each page returns up to 20 videos at 1 credit ($0.005) per request.
Example Usage
A content researcher fetches 100 recent videos from a creator's profile. First request returns 20 videos + max_cursor. Four more requests using the returned max_cursor each time yields 100 videos total. Cost: 5 credits ($0.025) plus 1 credit for the initial profile lookup.
Platforms
TikTok max_cursor Pagination is relevant across the following platforms, all accessible through Scavio's unified API:
- TikTok