TikTok-vermeldingen via de API: posts en reacties vinden die een account vermelden
De Mentions API van TikTok, onderdeel van de zakelijke API van TikTok, geeft via GET /business/mention/video/list/ de top 1.000 publieke posts van de afgelopen 90 dagen terug die een zakelijk account in hun bijschrift met @ vermelden, en via /business/mention/comment/list/ de top 1.000 reacties of antwoorden die het vermelden. Beide hebben de biz.brand.insights-scope nodig, plus een account met Advanced Access of een geverifieerd zakelijk account.
easyCoexistence koppelt een TikTok-account via de zakelijke API van TikTok: Claude, ChatGPT of je eigen code lezen de reacties en reageren erop met daarvoor bedoelde tools en ontvangen de reactie-gebeurtenissen zodra ze binnenkomen, en get_social_credentials geeft je eigen code het token voor andere aanroepen van de zakelijke API van TikTok, inclusief de Mentions-endpoints waar TikTok ze voor het account openstelt.
Maximum aantal vermelde posts dat /business/mention/video/list/ teruggeeft, allemaal publiek en van de afgelopen 90 dagen, tot 100 per verzoek.
Geschatte vertraging tussen een vermelding en de beschikbaarheid ervan via de Mentions API.
Latentie die TikTok opgeeft voor de Mentions-webhook nadat een gebruiker het bedrijf in een bijschrift of reactie vermeldt.
Hoe vaak TikTok aanraadt elk Mentions-endpoint per account aan te roepen, na de verversing van 0 tot 7 uur UTC.
Scope die /business/mention/comment/list/ naast biz.brand.insights nodig heeft om reacties te retourneren die het account vermelden.
Welke endpoints heeft de Mentions API?
Zes leesendpoints, elk een GET op https://business-api.tiktok.com/open_api/v1.3 met het access-token van het account in de Access-Token-header en zijn open_id als business_id. Twee tonen vermeldingen, twee vatten samen wat vermelde posts zeggen, en twee halen één vermelding op die een webhook aankondigde:
Welke posts en reacties tellen als vermelding?
Die de gebruikersnaam van het account met @ taggen, in het bijschrift van een post of in de tekst van een reactie, op een publieke post, en die de overige filters van TikTok doorstaan:
- De post is de afgelopen 90 dagen geplaatst.
- De auteur is niet minderjarig of van onbekende leeftijd: 17 of jonger geldt als minderjarig in Europa, 12 of jonger in de VS en andere regio's.
- Hij behoort tot de 1.000 posts of reacties met de meeste likes die de gebruikersnaam vermelden.
- De eigen posts van het bedrijf die aan deze regels voldoen, tellen ook mee.
- Reacties die alleen de vermelding bevatten, zonder andere tekst, worden lager gerangschikt.
Wat heeft een account nodig voordat het ze kan gebruiken?
Een geschikt account, een app met de juiste machtiging, de scopes op het token, en een dag wachttijd nadat de eigenaar de app autoriseert:
- Advanced Access of een geverifieerd zakelijk account;
has_advanced_accessop /business/get/ laat zien welke accounts in aanmerking komen. - De Mentions-machtiging op de ontwikkelaarsapp, vermeld als Mentions, Content voor posts en Mentions, Comment voor reacties.
- biz.brand.insights op het access-token, plus comment.list voor vermeldingen in reacties.
- 24 uur na autorisatie vóór de eerste ophaalactie, zoals de gids voor beginners van TikTok vraagt.
Hoe toon je posts die het account vermelden?
Met GET /business/mention/video/list/. fields kiest de gegevens, standaard item_id en caption, plus create_time, video_link, likes, comments, shares, thumbnail_url, views, reach en creator_handle_name op verzoek. sort_field neemt CREATE_TIME, LIKES, COMMENTS of SHARES met sort_type ASC of DESC, number_of_days versmalt de 90 dagen, regions houdt makers uit gekozen regio's over, en cursor met has_more bladert door de resultaten. views en reach tonen null onder 1.000, en miniatuurlinks blijven 48 uur geldig:
curl --get 'https://business-api.tiktok.com/open_api/v1.3/business/mention/video/list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["item_id","video_link","caption","likes","creator_handle_name"]' \
--data-urlencode 'sort_field=LIKES' \
--data-urlencode 'number_of_days=30' \
--data-urlencode 'max_count=100'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"videos": [
{
"item_id": "<ITEM_ID>",
"video_link": "https://www.tiktok.com/@/video/<ITEM_ID>",
"caption": "<CAPTION>",
"likes": 243,
"creator_handle_name": "<HANDLE>"
}
],
"cursor": 100,
"has_more": true
}
}Hoe toon je reacties die het account vermelden?
Met GET /business/mention/comment/list/, waarvan het token ook comment.list nodig heeft. Standaard geeft het comment_id en comment_text terug; item_id, video_link, caption, video_likes, thumbnail_url, commenter_display_name, comment_type, comment_create_time en comment_likes komen op verzoek, en comment_type leest COMMENT of REPLY. Een pagina bevat 10, tenzij max_count om tot 100 vraagt, gesorteerd op VIDEO_LIKES, COMMENT_CREATE_TIME of COMMENT_LIKES. Vanwege het beleid van TikTok voor vertrouwen en veiligheid kan een pagina kort terugkomen terwijl has_more nog steeds waar is.
Hoe reageer je op een vermelding?
Via het reactie-endpoint van TikTok. POST /business/comment/reply/create/ neemt business_id, video_id ingesteld op de item_id uit de reactievermelding, comment_id en een tekst van maximaal 1.200 tekens, en het antwoord verschijnt publiek onder die reactie, op welke post die ook staat. De referentie van TikTok noemt de comment.list.manage-scope en dezelfde accountvereiste daarvoor. De Mentions-referentie vermeldt een antwoord alleen voor reactievermeldingen.
Kunnen vermeldingen via webhook binnenkomen?
Ja. Met de Mentions-machtiging roept een app POST /business/webhook/update/ aan met event_type BRAND_MENTION, en TikTok stuurt dan brand.mention.event binnen maximaal twee tot drie uur na een vermelding, ondertekend in Tiktok-Signature zoals de andere webhooks. content is een geserialiseerde JSON-string met:
type_of_event: CREATE, EDIT ofPRIVACY_CHANGEvoor een wijziging van de privacy-instelling van een post.mention_type: COMMENT voor een reactie of antwoord,VIDEO_MENTIONvoor een bijschrift, waarbijcomment_id0 is.video_id,video_create_time,share_urlenvideo_caption, die de post beschrijven.open_id_of_mentioned_user,unique_name_of_mentioned_userenunique_identifier, een reactie-ID dat over alle API's hetzelfde blijft.- Details volgen via /business/mention/video/get/ of /business/mention/comment/get/, binnen 48 uur na de gebeurtenis.
Hoe vaak moeten de Mentions-endpoints worden aangeroepen?
Eén keer per dag per endpoint en per account, na 7 uur UTC, is het advies van TikTok. De endpoints delen de globale snelheidslimieten van de ontwikkelaarsapp, maar TikTok ververst de gegevens van de vorige dag tussen middernacht en 7 uur UTC, en extra ophaalacties binnen dezelfde dag zijn volgens TikTok overbodig. Een nieuwe vermelding heeft ook ongeveer 24 tot 48 uur nodig om de lijstendpoints te bereiken, waardoor de webhook het snelste signaal is.
Hoe werken merk-hashtags?
Ze verbreden vermeldingen naar posts die hashtags gebruiken die het bedrijf heeft gekozen. POST /business/mention/hashtag/add/ activeert tot 10 hashtags per verzoek en 50 per account, gekozen uit de maximaal 100 die /business/mention/hashtag/verify/list/ voorstelt, of met de volledige gebruikersnaam erin, zoals #drinktiktok voor @TikTok. Een geactiveerde hashtag kan zeven dagen niet worden verwijderd, en de posts ervan verschijnen in /business/mention/hashtag/video/list/ 24 uur nadat hij is geactiveerd.
Wat kan easyCoexistence met TikTok-vermeldingen?
Geef je eigen code het token van het account: get_social_credentials geeft het token en de business_id terug voor paden van de zakelijke API van TikTok onder business/, waaronder business/mention/. TikTok antwoordt wanneer het account en de app aan de hierboven genoemde vereisten voldoen. Vermeldingswebhooks vallen erbuiten: easyCoexistence abonneert zijn app alleen op reactie-gebeurtenissen en houdt de paden business/webhook/ voor zichzelf, dus BRAND_MENTION-gebeurtenissen worden niet doorgestuurd. Reacties op de eigen posts van het account, vermeldingen inbegrepen, komen nog steeds aan als comment.update-gebeurtenissen, die set_social_webhook_destination doorstuurt:
GET https://business-api.tiktok.com/open_api/v1.3/business/mention/comment/list/
?business_id=<BUSINESS_ID>
&fields=["item_id","comment_id","comment_text","commenter_display_name","comment_type"]
&sort_field=COMMENT_CREATE_TIME&max_count=50
Access-Token: <ACCESS_TOKEN>
POST https://business-api.tiktok.com/open_api/v1.3/business/comment/reply/create/
Access-Token: <ACCESS_TOKEN>
{ "business_id": "<BUSINESS_ID>", "video_id": "<ITEM_ID>", "comment_id": "<COMMENT_ID>", "text": "Thanks for the mention!" }Veelgemaakte fouten
- De Mentions-endpoints aanroepen voor een account zonder Advanced Access. TikTok levert ze aan accounts met Advanced Access of een geverifieerd zakelijk account, wat has_advanced_access op /business/get/ aangeeft.
- Vermeldingen ophalen net na middernacht UTC. TikTok ververst de gegevens van de vorige dag tussen middernacht en 7 uur UTC, dus een ophaalactie na 7 uur ziet de hele dag.
- Een comment_id van 0 lezen als reactie. In een vermeldings-webhook betekent het dat de vermelding in het bijschrift van de post staat, met mention_type VIDEO_MENTION.
- Een merk-hashtag activeren om hem uit te proberen. TikTok houdt een geactiveerde hashtag zeven dagen vast voordat hij kan worden verwijderd, en hij telt mee voor de 50 van het account.
Van US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Kan de TikTok API video's vinden die mijn account vermelden?
Ja, posts die de gebruikersnaam met @ in het bijschrift vermelden. /business/mention/video/list/ geeft tot 1.000 publieke posts van de afgelopen 90 dagen terug, met creator_handle_name die elke maker noemt.
Tellen privéposts van TikTok als vermelding?
Nee. De Mentions API telt alleen publieke posts van de afgelopen 90 dagen en laat auteurs weg die minderjarig of van onbekende leeftijd zijn: 17 of jonger in Europa, 12 of jonger in de VS en andere regio's.
Hoe lang duurt het voordat een vermelding op TikTok zichtbaar is?
Ongeveer 24 tot 48 uur via de lijstendpoints, en maximaal twee tot drie uur via de Mentions-webhook.
Kan easyCoexistence me waarschuwen als mijn TikTok-account wordt vermeld?
Niet als doorgestuurde gebeurtenis, want het stuurt de reactie-gebeurtenissen van TikTok door en niet de vermeldingsgebeurtenissen. Je eigen code kan vermeldingen op verzoek lezen, met het token uit get_social_credentials, waar het account in aanmerking komt.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op