LumenClip DocsData
Publishing, calendar, and analytics
Social integrations, publication records, calendar views, and analytics snapshots.
Publishing, calendar, and analytics
These objects describe distribution and measurement after content has been generated.
Publishing, calendar, and analytics. Optionality and accepted values are included in each field description.
CalendarItem
| Field | Type | Example | Description |
|---|---|---|---|
id | string | "record-123" | Required. Calendar identity. Accepted format: Stable computed/source ID. |
status | string enum | "planned" | Required. Unified lifecycle. Accepted format: planned, generating, generation_failed, needs_action, draft, failed, scheduled, published. |
datetime | ISO datetime | "Example" | Required. Primary display time. Accepted format: ISO 8601. |
slot | ISO datetime | "Example" | Optional. Queue dedupe slot. Accepted format: Exact automation slot. |
timezone | string | "Asia/Singapore" | Required. Display/scheduling zone. Accepted format: IANA timezone. |
automationId | string | "record-123" | Optional. Associated automation. Accepted format: Automation ID. |
automationName | string | "Example" | Optional. Automation label. |
targets | CalendarTarget[] | [] | Required. Destinations. Accepted format: Per-target provider/status. |
source | string enum | "projection" | Required. Materialization source. Accepted format: projection, job, local_post, postfast. |
sourceType | string | "Example" | Required. Origin category. Accepted format: Domain source type. |
sourceId | string | "record-123" | Required. Origin record. Accepted format: Domain source ID. |
title | string | "Example" | Required. Display title. |
excerpt | string | "Example" | Optional. Preview text. |
previewUrl | string | "https://example.com/item" | Optional. Preview media. Accepted format: URL/path. |
paused | boolean | true | Optional. Automation pause state. Accepted format: true, false. |
error | string | "Example" | Optional. Lifecycle failure. |
links | object | "content" | Required. Available actions. Accepted format: Optional content, automation, live, cancel, reschedule, retry URLs. |
timestamps | object | "2026-08-01T09:00:00.000Z" | Required. Timeline. Accepted format: Optional created/updated/scheduled/published/generated/expected times. |
TikTokStudioAnalytics
| Field | Type | Example | Description |
|---|---|---|---|
schemaVersion | number literal | 1 | Required. Payload version. Accepted format: 1. |
studioUrl | string | "https://example.com/item" | Required. Capture source. Accepted format: TikTok Studio URL. |
capturedSections | string[] | "overview" | Required. Captured panels. Accepted format: overview, viewers, engagement. |
overview | object | { "key": "value" } | Optional. Overview panel. Accepted format: Optional author/caption/time/photo and KPI fields. |
slides | object[] | [] | Required. Slide analytics. Accepted format: Index, optional retention/like percentages and peak flags. |
trafficSources | number map | { source: percent } | Required. Traffic distribution. Accepted format: { source: percent }. |
searchTerms | object[] | { term, percent } | Required. Search traffic. Accepted format: { term, percent }. |
viewHistory7d | object[] | [] | Optional. TikTok Studio daily view buckets since posting. Accepted format: Offset, response status, and optional value. |
viewHistory48h | object[] | [] | Optional. TikTok Studio hourly view buckets since posting. Accepted format: Offset, response status, and optional value. |
audience | object | { "key": "value" } | Optional. Audience breakdown. Accepted format: Viewer/follower percentages and age/gender/country maps. |
AccountFollowerSnapshot
| Field | Type | Example | Description |
|---|---|---|---|
id | string | "record-123" | Required. Snapshot ID. Accepted format: Stable deterministic ID. |
integrationId | string | "record-123" | Required. Account. Accepted format: Integration ID. |
provider | string | "Example" | Required. Network. Accepted format: Provider string. |
capturedAt | ISO datetime | "Example" | Required. Capture time. Accepted format: ISO 8601. |
followers | number | 1 | Required. Follower count. Accepted format: Non-negative integer. |
netChange | number | 1 | Optional. Change from prior snapshot. Accepted format: Signed integer. |