Response format

How responses are structured using the ActivityStreams 2.0 standard.

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:

Property	Description
type	ActivityStreams object type (Person, Video, Note, etc.)
id	Canonical URL for the resource
url	Web URL for the resource
name	Display name
preferredUsername	Username/handle
summary	Bio or description
published	ISO 8601 timestamp
icon	Avatar or thumbnail
image	Cover image or media
attachment	Related media or links

The same code that processes a TikTok user works for an Instagram user — the field names and structure are identical.