API endpointsContent: tiktokGet one mention in full, hydrating a mention event GET

Get one mention in full, hydrating a mention event

GET
/v1/content/tiktok.posts.mentions/{externalId}

Get one mention in full, hydrating a mention event: TikTok's webhook payload carries no engagement counts or thumbnail, and no comment text or author handle for a comment mention. Details stay readable for 48 hours after the webhook.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

externalId*string
Length1 <= length

Query Parameters

connectedProfileId*string

Koil Connected Profile associated with the operation.

Length1 <= length
mediaExternalId*string
Length1 <= length
variant*|
includeProviderRaw?boolean

Whether to include transient provider-native payloads.

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/content/tiktok.posts.mentions/string?connectedProfileId=string&mediaExternalId=string&variant=caption"
{  "externalId": "string",  "variant": "caption",  "mediaExternalId": "string",  "commentExternalId": "string",  "text": "string",  "author": {    "id": "string",    "displayName": "string",    "username": "string"  },  "media": [    {      "mediaId": "string",      "sourceUrl": "string",      "contentType": "string",      "filename": "string",      "checksum": "string",      "altText": "string"    }  ],  "providerPermalink": "http://example.com",  "engagement": {    "likes": 0,    "comments": 0,    "shares": 0,    "views": 0  },  "publishedAt": "2019-08-24T14:15:22Z",  "providerRaw": null,  "contentType": "tiktok.posts.mentions"}
{  "error": {    "code": "validation_error",    "message": "string",    "meta": {      "property1": null,      "property2": null    }  }}

List the top mentions of the TikTok account in other users' captions or comments GET

List the top mentions of the TikTok account in other users' captions or comments.

List the TikTok Business Account's direct-message conversations from the last 90 days GET

List the TikTok Business Account's direct-message conversations from the last 90 days.