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.
PostFastSocialIntegration
| Field | Type | Example | Description |
|---|---|---|---|
provider | string enum | "tiktok" | Required. Network/provider. Accepted format: tiktok, tiktok-creative, tiktok-seller, youtube, instagram, facebook, x, twitter, linkedin, threads, pinterest, bluesky, telegram, google, google-business-profile. |
integration_id | string | "record-123" | Required. Connected account. Accepted format: Provider integration ID. |
name | string | "Example" | Required. Account name. |
profile | string | "Example" | Optional. Public identity. Accepted format: Handle/profile string. |
picture | string | "https://example.com/item" | Optional. Avatar. Accepted format: URL. |
disabled | boolean | true | Optional. Target disabled state. Accepted format: true, false. |
PostFastPostRecord
| Field | Type | Example | Description |
|---|---|---|---|
id | string | "record-123" | Required. Publication record ID. Accepted format: Stable domain ID. |
sourceType | string enum | "automation" | Required. Origin type. Accepted format: automation, x_automation, generated_video, asset, greenscreen, ugc_ad, image, slideshow, manual, external. |
sourceId | string | "record-123" | Required. Origin record. Accepted format: Domain ID. |
postfastPostId | string | "record-123" | Optional. Remote post. Accepted format: PostFast ID. |
integrationId | string | "record-123" | Required. Destination account. Accepted format: Integration ID. |
provider | string | "Example" | Required. Destination network. Accepted format: Provider string. |
status | string enum | "awaiting_manual_post" | Required. Publication lifecycle. Accepted format: awaiting_manual_post, ready_for_review, draft, scheduled, published, failed. |
scheduledAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Optional. Scheduled time. Accepted format: ISO 8601. |
publishedAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Optional. Publication time. Accepted format: ISO 8601. |
releaseUrl | string | "https://example.com/item" | Optional. Published post. Accepted format: URL. |
linkState | string enum | "postfast_published" | Required. Attribution/link state. Accepted format: postfast_published, manually_linked, unlinked. |
statsSources | string[] | "postfast" | Required. Available analytics sources. Accepted format: postfast, tiktok_studio. |
externalPostId | string | "record-123" | Optional. Manually linked post. Accepted format: Provider post ID. |
content | string | "Example" | Required. Published copy. |
media | PostFastMedia[] | "type" | Required. Uploaded media references. Accepted format: type: IMAGE or VIDEO; optional sortOrder. |
createdAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Required. Creation time. Accepted format: ISO 8601. |
updatedAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Required. Last update. Accepted format: ISO 8601. |
lastSyncedAt | ISO datetime | "Example" | Optional. Publication sync time. Accepted format: ISO 8601. |
lastAnalyticsSyncedAt | ISO datetime | "Example" | Optional. Analytics sync time. Accepted format: ISO 8601. |
analytics | metric series[] | [] | Optional. Provider analytics history. Accepted format: Label + dated totals. |
error | string | "Example" | Optional. Publication failure. |
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. |
PostFastMetricSnapshot
| Field | Type | Example | Description |
|---|---|---|---|
id | string | "record-123" | Required. Snapshot ID. Accepted format: Deterministic post/time ID. |
postId | string | "record-123" | Required. Parent post. Accepted format: Publication ID. |
platformPostId | string | "record-123" | Optional. Native post. Accepted format: Provider 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. |
publishedAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Optional. Publication time. Accepted format: ISO 8601. |
content | string | "Example" | Optional. Post copy snapshot. |
thumbnailUrl | string | "https://example.com/item" | Optional. Preview. Accepted format: URL. |
releaseUrl | string | "https://example.com/item" | Optional. Published post. Accepted format: URL. |
sourceType | string | "Example" | Optional. Origin category. Accepted format: Domain source type. |
sourceId | string | "record-123" | Optional. Origin record. Accepted format: Domain ID. |
contentType | string enum | "slideshow" | Optional. Normalized post form. Accepted format: slideshow, video, image, text, external. |
mediaCount | number | 1 | Optional. Attached media count. Accepted format: Non-negative integer. |
metrics | metric map | "views" | Required. Canonical metrics. Accepted format: Keys views, impressions, reach, likes, comments, shares, saves, clicks, followers, interactions, engagementRate. |
latestMetric | object | { "key": "value" } | Required. Latest provider payload. Accepted format: JSON object. |
rawMetrics | number map | 1 | Required. Raw numeric metrics. Accepted format: Provider metric keys. |
observedKeys | string[] | [] | Required. Provider keys seen. Accepted format: Array. |
source | string enum | "postfast" | Optional. Capture source. Accepted format: postfast, tiktok_studio. |
tiktokStudio | TikTokStudioAnalytics | "Example" | Optional. Studio-only detail. Accepted format: See below. |
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. |