API endpointsContent: tiktokList 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 top mentions of the TikTok account in other users' captions or comments.
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Query Parameters
connectedProfileId*string
Koil Connected Profile associated with the operation.
Length
1 <= lengthvariant*|
days?integer
Look-back window in days; defaults to 90.
Range
1 <= value <= 90cursor?string
Opaque cursor for fetching the next result page.
Length
1 <= lengthlimit?number
Maximum number of items to return.
Range
1 <= valueincludeProviderRaw?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?connectedProfileId=string&variant=caption"{ "data": [ { "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" } ], "nextCursor": "string", "hasMore": true}{ "error": { "code": "validation_error", "message": "string", "meta": { "property1": null, "property2": null } }}Hide, unhide, like, or unlike a TikTok comment POST
Hide, unhide, like, or unlike a TikTok comment.
Get one mention in full, hydrating a mention event GET
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.