integrations/social/tiktok/dist¶
Interfaces¶
ParseTikTokWebhookOptions¶
Properties¶
clientSecret?¶
nowSeconds?¶
requireSignature?¶
toleranceSeconds?¶
TikTokApiResponse¶
Type Parameters¶
| Type Parameter | Default type |
|---|---|
T extends TikTokSocialProviderExtensionValue |
TikTokSocialJsonObject |
Indexable¶
Properties¶
code?¶
data?¶
error?¶
code?¶
log_id?¶
message?¶
message?¶
request_id?¶
TikTokBusinessCommentListInput¶
Properties¶
businessId?¶
cursor?¶
fields?¶
pageSize?¶
status?¶
videoId¶
TikTokBusinessVideoListInput¶
Properties¶
businessId?¶
fields?¶
filters?¶
TikTokComment¶
Indexable¶
Properties¶
create_time?¶
id?¶
like_count?¶
parent_comment_id?¶
reply_count?¶
text?¶
video_id?¶
TikTokCommentList¶
Indexable¶
Properties¶
comments?¶
cursor?¶
has_more?¶
TikTokCommentReplyInput¶
Properties¶
additionalFields?¶
businessId?¶
commentId¶
text¶
videoId¶
TikTokCredentialStatusInput¶
Properties¶
accessToken?¶
businessId?¶
clientKey?¶
clientSecret?¶
expiresAt?¶
openId?¶
scopes?¶
webhookConfigured?¶
webhookSignatureSecret?¶
TikTokGeneralDmSupport¶
Properties¶
alternatives¶
reason¶
supported¶
TikTokLiveCheckOptions¶
Extends¶
Properties¶
accessToken?¶
Inherited from¶
TikTokSocialClientOptions.accessToken
baseUrl?¶
Inherited from¶
TikTokSocialClientOptions.baseUrl
businessApiBaseUrl?¶
Inherited from¶
TikTokSocialClientOptions.businessApiBaseUrl
businessApiVersion?¶
Inherited from¶
TikTokSocialClientOptions.businessApiVersion
businessId?¶
Inherited from¶
TikTokSocialClientOptions.businessId
client?¶
clientKey?¶
Inherited from¶
TikTokSocialClientOptions.clientKey
clientSecret?¶
Inherited from¶
TikTokSocialClientOptions.clientSecret
fetch?¶
Call Signature¶
Parameters¶
| Parameter | Type |
|---|---|
input |
URL | RequestInfo |
init? |
RequestInit |
Returns¶
Promise\<Response>
Call Signature¶
Parameters¶
| Parameter | Type |
|---|---|
input |
string | Request | URL |
init? |
RequestInit |
Returns¶
Promise\<Response>
Inherited from¶
TikTokSocialClientOptions.fetch
openApiBaseUrl?¶
Inherited from¶
TikTokSocialClientOptions.openApiBaseUrl
openId?¶
Inherited from¶
TikTokSocialClientOptions.openId
providerClient?¶
Inherited from¶
TikTokSocialClientOptions.providerClient
retry?¶
Inherited from¶
TikTokSocialClientOptions.retry
signal?¶
Inherited from¶
TikTokSocialClientOptions.signal
timeoutMs?¶
Inherited from¶
TikTokSocialClientOptions.timeoutMs
TikTokPostStatusInput¶
Properties¶
publishId¶
TikTokResearchCommentListInput¶
Properties¶
commentId?¶
cursor?¶
fields?¶
maxCount?¶
videoId?¶
TikTokSelectedOperation¶
Properties¶
api¶
api:
| "tiktok-open.v2.display"
| "tiktok-open.v2.content-posting"
| "tiktok-open.v2.research"
| "tiktok-business.v1.3";
functionName¶
method¶
path¶
sourceUrl¶
uid¶
TikTokSignatureParts¶
Properties¶
signature?¶
timestamp?¶
TikTokSignedWebhook¶
Properties¶
contentType?¶
payload¶
rawBody¶
signature?¶
timestamp?¶
TikTokSocialClient¶
Extends¶
Properties¶
providerClient¶
Methods¶
createBusinessComment()¶
Parameters¶
| Parameter | Type |
|---|---|
input |
Omit\<TikTokCommentReplyInput, "commentId"> |
Returns¶
Promise\<TikTokApiResponse\<TikTokSocialJsonObject>>
Inherited from¶
TikTokSocialProviderClient.createBusinessComment
fetchPostStatus()¶
Parameters¶
| Parameter | Type |
|---|---|
input |
TikTokPostStatusInput |
Returns¶
Promise\<TikTokApiResponse\<TikTokSocialJsonObject>>
Inherited from¶
TikTokSocialProviderClient.fetchPostStatus
getUserInfo()¶
Parameters¶
| Parameter | Type |
|---|---|
fields? |
string[] |
Returns¶
Promise\<TikTokApiResponse\<TikTokUserInfo>>
Inherited from¶
TikTokSocialProviderClient.getUserInfo
listBusinessComments()¶
Parameters¶
| Parameter | Type |
|---|---|
input |
TikTokBusinessCommentListInput |
Returns¶
Promise\<TikTokApiResponse\<TikTokCommentList>>
Inherited from¶
TikTokSocialProviderClient.listBusinessComments
listBusinessVideos()¶
Parameters¶
| Parameter | Type |
|---|---|
input? |
TikTokBusinessVideoListInput |
Returns¶
Promise\<TikTokApiResponse\<TikTokSocialJsonObject>>
Inherited from¶
TikTokSocialProviderClient.listBusinessVideos
listVideos()¶
Parameters¶
| Parameter | Type |
|---|---|
input? |
TikTokVideoListInput |
Returns¶
Promise\<TikTokApiResponse\<TikTokVideoList>>
Inherited from¶
TikTokSocialProviderClient.listVideos
queryResearchVideoComments()¶
Parameters¶
| Parameter | Type |
|---|---|
input |
TikTokResearchCommentListInput |
Returns¶
Promise\<TikTokApiResponse\<TikTokCommentList>>
Inherited from¶
TikTokSocialProviderClient.queryResearchVideoComments
replyToBusinessComment()¶
Parameters¶
| Parameter | Type |
|---|---|
input |
TikTokCommentReplyInput |
Returns¶
Promise\<TikTokApiResponse\<TikTokSocialJsonObject>>
Inherited from¶
TikTokSocialProviderClient.replyToBusinessComment
TikTokSocialClientOptions¶
Extended by¶
Properties¶
accessToken?¶
baseUrl?¶
businessApiBaseUrl?¶
businessApiVersion?¶
businessId?¶
clientKey?¶
clientSecret?¶
fetch?¶
Call Signature¶
Parameters¶
| Parameter | Type |
|---|---|
input |
URL | RequestInfo |
init? |
RequestInit |
Returns¶
Promise\<Response>
Call Signature¶
Parameters¶
| Parameter | Type |
|---|---|
input |
string | Request | URL |
init? |
RequestInit |
Returns¶
Promise\<Response>
openApiBaseUrl?¶
openId?¶
providerClient?¶
retry?¶
signal?¶
timeoutMs?¶
TikTokSocialJsonObject¶
Extended by¶
Indexable¶
TikTokSocialProviderClient¶
Extended by¶
Methods¶
createBusinessComment()¶
Parameters¶
| Parameter | Type |
|---|---|
input |
Omit\<TikTokCommentReplyInput, "commentId"> |
Returns¶
Promise\<TikTokApiResponse\<TikTokSocialJsonObject>>
fetchPostStatus()¶
Parameters¶
| Parameter | Type |
|---|---|
input |
TikTokPostStatusInput |
Returns¶
Promise\<TikTokApiResponse\<TikTokSocialJsonObject>>
getUserInfo()¶
Parameters¶
| Parameter | Type |
|---|---|
fields? |
string[] |
Returns¶
Promise\<TikTokApiResponse\<TikTokUserInfo>>
listBusinessComments()¶
Parameters¶
| Parameter | Type |
|---|---|
input |
TikTokBusinessCommentListInput |
Returns¶
Promise\<TikTokApiResponse\<TikTokCommentList>>
listBusinessVideos()¶
Parameters¶
| Parameter | Type |
|---|---|
input? |
TikTokBusinessVideoListInput |
Returns¶
Promise\<TikTokApiResponse\<TikTokSocialJsonObject>>
listVideos()¶
Parameters¶
| Parameter | Type |
|---|---|
input? |
TikTokVideoListInput |
Returns¶
Promise\<TikTokApiResponse\<TikTokVideoList>>
queryResearchVideoComments()¶
Parameters¶
| Parameter | Type |
|---|---|
input |
TikTokResearchCommentListInput |
Returns¶
Promise\<TikTokApiResponse\<TikTokCommentList>>
replyToBusinessComment()¶
Parameters¶
| Parameter | Type |
|---|---|
input |
TikTokCommentReplyInput |
Returns¶
Promise\<TikTokApiResponse\<TikTokSocialJsonObject>>
TikTokSocialProviderExtensionFields¶
Extends¶
Indexable¶
TikTokSocialProviderResponse¶
Extends¶
Indexable¶
TikTokUserInfo¶
Indexable¶
Properties¶
user?¶
optional user?: {
[key: string]: TikTokSocialProviderExtensionValue;
avatar_large_url?: string;
avatar_url?: string;
avatar_url_100?: string;
bio_description?: string;
display_name?: string;
follower_count?: number;
following_count?: number;
is_verified?: boolean;
likes_count?: number;
open_id?: string;
profile_deep_link?: string;
union_id?: string;
username?: string;
video_count?: number;
};
Index Signature¶
avatar_large_url?¶
avatar_url?¶
avatar_url_100?¶
bio_description?¶
display_name?¶
follower_count?¶
following_count?¶
is_verified?¶
likes_count?¶
open_id?¶
profile_deep_link?¶
union_id?¶
username?¶
video_count?¶
TikTokVideo¶
Indexable¶
Properties¶
comment_count?¶
cover_image_url?¶
create_time?¶
duration?¶
embed_html?¶
embed_link?¶
height?¶
id?¶
like_count?¶
share_count?¶
share_url?¶
title?¶
video_description?¶
view_count?¶
width?¶
TikTokVideoList¶
Indexable¶
Properties¶
cursor?¶
has_more?¶
video_list?¶
videos?¶
TikTokVideoListInput¶
Properties¶
cursor?¶
fields?¶
maxCount?¶
TikTokWebhookPayload¶
Indexable¶
Properties¶
client_key?¶
create_time?¶
data?¶
event?¶
event_id?¶
event_name?¶
user_open_id?¶
ValidateTikTokWebhookSignatureInput¶
Properties¶
clientSecret¶
nowSeconds?¶
rawBody¶
signatureHeader¶
toleranceSeconds?¶
Type Aliases¶
TikTokSocialJsonPrimitive¶
TikTokSocialJsonValue¶
type TikTokSocialJsonValue =
| TikTokSocialJsonPrimitive
| TikTokSocialJsonObject
| readonly TikTokSocialJsonValue[];
TikTokSocialProviderExtensionValue¶
TikTokSocialProviderPayload¶
TikTokSocialProviderQuery¶
Variables¶
TIKTOK_HOST_CLIENT_SUPPORT_SLICE¶
const TIKTOK_HOST_CLIENT_SUPPORT_SLICE: {
allowedOperations: {
alias: string;
id: string;
providerApi: | "tiktok-open.v2.display"
| "tiktok-open.v2.content-posting"
| "tiktok-open.v2.research"
| "tiktok-business.v1.3";
providerPath: string;
source: string;
sourceUrl: string;
target: string;
}[];
apiCoverage: {
checkedAt: "2026-06-25";
operationCatalog: "package:src/selected-operations.ts";
};
checkedAt: "2026-06-25";
implementationStrategy: "no-official-sdk-rest-adapter";
providerRestAdapterException: {
checkedAt: "2026-06-25";
checkedVersion: "1.1.3";
defaultClientPolicy: "built-in-tiktok-rest-adapter";
license: "Unlicense";
reason: "The official JavaScript SDK only targets TikTok Business API generated clients. Its CommentsApi exposes the Business comment list/post surface, but it does not cover TikTok Developers Open API Display reads, Research API comment reads, Content Posting status reads, webhook verification, or the full mixed selected support surface required by this package.";
result: "sdk-not-suitable-for-mixed-social-surface";
sdkPackage: "tiktok-business-api-sdk-official";
typedClientOverride: "TikTokSocialProviderClient";
};
sdkDecision: {
auditedPackages: readonly [{
package: "tiktok-business-api-sdk-official";
reason: "CommentsApi covers a Business comment surface, but the package does not expose the full mixed TikTok Developers/Business support surface selected by this adapter.";
source: "npm + tiktok/tiktok-business-api-sdk";
status: "not-suitable";
version: "1.1.3";
}];
notes: readonly ["TikTok OpenSDK is an official mobile Login/Share Kit, not a server-side JavaScript/TypeScript client for this selected support surface.", "The official TikTok Business API SDK is a broad Business API package with comment helpers, but it does not cover TikTok Developers Open API Display, Research API, Content Posting status, or webhook verification for this mixed adapter surface.", "This package therefore ships a built-in REST adapter for the selected operations and still accepts an injected TikTok provider client override."];
viableOfficialSdk: false;
};
selectedOperationChecksum: string;
selectedOperationChecksumAlgorithm: "sha256";
selectedOperations: (
| {
api: "tiktok-open.v2.display";
functionName: string;
method: "GET";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-open.v2.display";
functionName: string;
method: "POST";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-open.v2.content-posting";
functionName: string;
method: "POST";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-open.v2.research";
functionName: string;
method: "POST";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-business.v1.3";
functionName: string;
method: "GET";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-business.v1.3";
functionName: string;
method: "POST";
path: string;
sourceUrl: string;
uid: string;
})[];
source: "official TikTok Developers and TikTok Business API docs";
sourceVersion: "TikTok Open API v2 + Business API v1.3 public docs checked 2026-06-25";
};
Type Declaration¶
TIKTOK_SELECTED_OPERATION_COUNT¶
TIKTOK_SELECTED_OPERATIONS¶
const TIKTOK_SELECTED_OPERATIONS: (
| {
api: "tiktok-open.v2.display";
functionName: string;
method: "GET";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-open.v2.display";
functionName: string;
method: "POST";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-open.v2.content-posting";
functionName: string;
method: "POST";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-open.v2.research";
functionName: string;
method: "POST";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-business.v1.3";
functionName: string;
method: "GET";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-business.v1.3";
functionName: string;
method: "POST";
path: string;
sourceUrl: string;
uid: string;
})[];
TIKTOK_SUPPORT_SLICE¶
const TIKTOK_SUPPORT_SLICE: {
allowedOperations: {
alias: string;
id: string;
providerApi: | "tiktok-open.v2.display"
| "tiktok-open.v2.content-posting"
| "tiktok-open.v2.research"
| "tiktok-business.v1.3";
providerPath: string;
source: string;
sourceUrl: string;
target: string;
}[];
apiCoverage: {
checkedAt: "2026-06-25";
operationCatalog: "package:src/selected-operations.ts";
};
checkedAt: "2026-06-25";
implementationStrategy: "no-official-sdk-rest-adapter";
providerRestAdapterException: {
checkedAt: "2026-06-25";
checkedVersion: "1.1.3";
defaultClientPolicy: "built-in-tiktok-rest-adapter";
license: "Unlicense";
reason: "The official JavaScript SDK only targets TikTok Business API generated clients. Its CommentsApi exposes the Business comment list/post surface, but it does not cover TikTok Developers Open API Display reads, Research API comment reads, Content Posting status reads, webhook verification, or the full mixed selected support surface required by this package.";
result: "sdk-not-suitable-for-mixed-social-surface";
sdkPackage: "tiktok-business-api-sdk-official";
typedClientOverride: "TikTokSocialProviderClient";
};
sdkDecision: {
auditedPackages: readonly [{
package: "tiktok-business-api-sdk-official";
reason: "CommentsApi covers a Business comment surface, but the package does not expose the full mixed TikTok Developers/Business support surface selected by this adapter.";
source: "npm + tiktok/tiktok-business-api-sdk";
status: "not-suitable";
version: "1.1.3";
}];
notes: readonly ["TikTok OpenSDK is an official mobile Login/Share Kit, not a server-side JavaScript/TypeScript client for this selected support surface.", "The official TikTok Business API SDK is a broad Business API package with comment helpers, but it does not cover TikTok Developers Open API Display, Research API, Content Posting status, or webhook verification for this mixed adapter surface.", "This package therefore ships a built-in REST adapter for the selected operations and still accepts an injected TikTok provider client override."];
viableOfficialSdk: false;
};
selectedOperationChecksum: string;
selectedOperationChecksumAlgorithm: "sha256";
selectedOperations: (
| {
api: "tiktok-open.v2.display";
functionName: string;
method: "GET";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-open.v2.display";
functionName: string;
method: "POST";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-open.v2.content-posting";
functionName: string;
method: "POST";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-open.v2.research";
functionName: string;
method: "POST";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-business.v1.3";
functionName: string;
method: "GET";
path: string;
sourceUrl: string;
uid: string;
}
| {
api: "tiktok-business.v1.3";
functionName: string;
method: "POST";
path: string;
sourceUrl: string;
uid: string;
})[];
source: "official TikTok Developers and TikTok Business API docs";
sourceVersion: "TikTok Open API v2 + Business API v1.3 public docs checked 2026-06-25";
};
Type Declaration¶
Functions¶
createTikTokBusinessCommentReply()¶
function createTikTokBusinessCommentReply(input, defaultBusinessId?): {
[k: string]: TikTokSocialProviderExtensionValue;
};
Parameters¶
| Parameter | Type |
|---|---|
input |
TikTokCommentReplyInput |
defaultBusinessId? |
string |
Returns¶
createTikTokRestProviderClient()¶
Parameters¶
| Parameter | Type |
|---|---|
options |
TikTokSocialClientOptions |
Returns¶
createTikTokSocialClient()¶
Parameters¶
| Parameter | Type |
|---|---|
options? |
TikTokSocialClientOptions |
Returns¶
createTikTokSocialLiveChecks()¶
function createTikTokSocialLiveChecks(options): {
description: string;
id: string;
requiredCredentialIds: string[];
run: Promise<{
details: {
displayName: string;
openId: string;
username: string;
};
}>;
}[];
Parameters¶
| Parameter | Type |
|---|---|
options |
TikTokLiveCheckOptions |
Returns¶
{
description: string;
id: string;
requiredCredentialIds: string[];
run: Promise\<{
details: {
displayName: string;
openId: string;
username: string;
};
}>;
}[]
getTikTokGeneralDmSupport()¶
Returns¶
parseTikTokSignatureHeader()¶
Parameters¶
| Parameter | Type |
|---|---|
header |
string |
Returns¶
parseTikTokWebhook()¶
Parameters¶
| Parameter | Type |
|---|---|
request |
Request |
options? |
ParseTikTokWebhookOptions |
Returns¶
Promise\<TikTokSignedWebhook>
tiktokSocialCredentialStatuses()¶
function tiktokSocialCredentialStatuses(input): {
expiresAt?: string;
message?: string;
providerPackageId?: string;
requirementId: string;
scopes?: string[];
state: | "required"
| "configured"
| "permission-blocked"
| "not-required"
| "missing"
| "expired"
| "insufficient-scope"
| "unavailable";
}[];
Parameters¶
| Parameter | Type |
|---|---|
input |
TikTokCredentialStatusInput |
Returns¶
{
expiresAt?: string;
message?: string;
providerPackageId?: string;
requirementId: string;
scopes?: string[];
state: | "required"
| "configured"
| "permission-blocked"
| "not-required"
| "missing"
| "expired"
| "insufficient-scope"
| "unavailable";
}[]
validateTikTokWebhookSignature()¶
Parameters¶
| Parameter | Type |
|---|---|
input |
ValidateTikTokWebhookSignatureInput |
Returns¶
boolean
References¶
tiktokSocialProviderManifest¶
Re-exports tiktokSocialProviderManifest