Skip to main content
All list endpoints use cursor-based pagination. This ensures consistent results even when the underlying data changes between requests.

​
Parameters

ParameterTypeDescription
cursorstringCursor for the next page. Omit for the first page.
countintegerNumber of items per page.

​
Response fields

Paginated responses use the OrderedCollectionPage type: 
{
  "@context": ["https://www.w3.org/ns/activitystreams#", "https://konbiniapi.com/ns/social#"],
  "type": "OrderedCollectionPage",
  "partOf": "https://api.konbiniapi.com/v1/tiktok/users/example/videos",
  "totalItems": 342,
  "itemCount": 30,
  "cursor": "abc123",
  "nextCursor": "def456",
  "next": "https://api.konbiniapi.com/v1/tiktok/users/example/videos?cursor=def456&count=30",
  "orderedItems": [...]
}
FieldDescription
totalItemsTotal number of items in the collection (may be null for some endpoints)
itemCountNumber of items in this page
nextCursorCursor for the next page, null if there are no more pages
nextPre-built URL to fetch the next page
orderedItemsThe items in this page

​
Iterating through pages

Use the next URL directly, or pass nextCursor as the cursor parameter in your next request. When nextCursor is null, you’ve reached the last page. 
# First page
curl "https://api.konbiniapi.com/v1/tiktok/users/example/videos?count=30" \
  -H "Authorization: Bearer knbn_your_api_key"

# Next page (using nextCursor from previous response)
curl "https://api.konbiniapi.com/v1/tiktok/users/example/videos?cursor=def456&count=30" \
  -H "Authorization: Bearer knbn_your_api_key"