Skip to main content
All responses follow the W3C ActivityStreams 2.0 specification with KonbiniAPI extensions.

​
Context

Every response includes an @context array identifying the vocabularies used: 
{
  "@context": [
    "https://www.w3.org/ns/activitystreams#",
    "https://konbiniapi.com/ns/social#"
  ]
}
The first context is the standard ActivityStreams vocabulary. The second adds platform-specific properties like followerCount, isVerified, and viewCount.

​
Object types

​
Detail endpoints

Endpoints that return a single resource (e.g. a user or video) return the object directly: 
{
  "@context": [...],
  "type": "Person",
  "id": "https://www.tiktok.com/@example",
  "name": "Example User",
  "preferredUsername": "example",
  "followerCount": 50000,
  "isVerified": true
}

​
List endpoints

Endpoints that return multiple items use OrderedCollectionPage: 
{
  "@context": [...],
  "type": "OrderedCollectionPage",
  "totalItems": 342,
  "itemCount": 30,
  "nextCursor": "abc123",
  "orderedItems": [...]
}
See pagination for details on navigating through pages.

​
Common properties

Properties are consistent across platforms:
PropertyDescription
typeActivityStreams object type (Person, Video, Note, etc.)
idCanonical URL for the resource
urlWeb URL for the resource
nameDisplay name
preferredUsernameUsername/handle
summaryBio or description
publishedISO 8601 timestamp
iconAvatar or thumbnail
imageCover image or media
attachmentRelated media or links
The same code that processes a TikTok user works for an Instagram user — the field names and structure are identical.