Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Mențiuni TikTok prin API: postări și comentarii care menționează un cont

API-ul Mentions, parte din API for Business, returnează primele 1.000 de postări publice din ultimele 90 de zile care îi @menționează contul de afacere în legendă, prin GET /business/mention/video/list/, și primele 1.000 de comentarii sau răspunsuri care îl menționează, prin /business/mention/comment/list/. Ambele necesită scope-ul biz.brand.insights și un cont cu Advanced Access sau un cont Business verificat.

easyCoexistence conectează un cont TikTok prin API for Business al TikTok: Claude, ChatGPT sau propriul tău cod citesc comentariile și răspund la ele cu instrumente dedicate și primesc evenimentele de comentarii pe măsură ce sosesc, iar get_social_credentials oferă propriului tău cod token-ul pentru alte apeluri API for Business, inclusiv endpoint-urile Mentions acolo unde TikTok le deschide contului.

1,000

Cele mai multe postări cu mențiuni pe care le returnează /business/mention/video/list/, toate publice și din ultimele 90 de zile, până la 100 per cerere.

24 to 48 hours

Întârzierea aproximativă dintre momentul în care se face o mențiune și disponibilitatea ei prin Mentions API.

2 to 3 hours

Latența pe care TikTok o indică pentru webhook-ul Mentions, după ce un utilizator menționează afacerea într-o legendă sau un comentariu.

Once a day

Cât de des recomandă TikTok apelarea fiecărui endpoint Mentions pe cont, după reîmprospătarea datelor între 00:00 și 07:00 UTC.

comment.list

Scope-ul /business/mention/comment/list/ necesită, alături de biz.brand.insights, pentru a returna comentariile care menționează contul.

Ce endpoint-uri are Mentions API?

Șase endpoint-uri de citire, fiecare un GET pe https://business-api.tiktok.com/open_api/v1.3, cu token-ul de acces al contului în antetul Access-Token și open_id-ul acestuia drept business_id. Două listează mențiunile, două rezumă ce spun postările cu mențiuni, iar două preiau o singură mențiune pe care a anunțat-o un webhook:

/business/mention/video/list/Up to 1,000 posts whose caption mentions the account, 100 a page
/business/mention/comment/list/Up to 1,000 comments or replies whose text mentions the account
/business/mention/top_word/list/The 20 keywords that appear most in mentioned posts' captions
/business/mention/top_hashtag/list/The 20 hashtags used most in those captions
/business/mention/video/get/One mentioned post from a webhook event, within 48 hours
/business/mention/comment/get/One comment mention from a webhook event, within 48 hours

Ce postări și comentarii se numără drept mențiuni?

Cele care etichetează numele de utilizator al contului cu @, în legenda unei postări sau în textul unui comentariu, pe o postare publică, și care trec de celelalte filtre ale TikTok:

  • Postarea a fost publicată în ultimele 90 de zile.
  • Autorul nu este minor sau de vârstă necunoscută: 17 ani sau mai puțin înseamnă minor în Europa, 12 ani sau mai puțin în SUA și alte regiuni.
  • Face parte din primele 1.000 de postări sau comentarii cele mai apreciate care menționează numele de utilizator.
  • Postările proprii ale afacerii care respectă aceste reguli se numără și ele.
  • Comentariile formate doar din mențiune, fără alt text, sunt clasate mai jos.

Ce are nevoie un cont înainte să le folosească?

Un cont eligibil, o aplicație cu permisiunea potrivită, scope-urile pe token-ul de acces și o zi de așteptare după ce proprietarul autorizează aplicația:

  • Advanced Access sau un cont Business verificat; has_advanced_access de la /business/get/ arată ce conturi se califică.
  • Permisiunea Mentions în aplicația de dezvoltator, listată ca Mentions, Content pentru postări și Mentions, Comment pentru comentarii.
  • biz.brand.insights pe token-ul de acces, plus comment.list pentru mențiunile din comentarii.
  • 24 de ore după autorizare înainte de prima interogare, cum cere ghidul de pornire al TikTok.

Cum listezi postările care menționează contul?

Cu GET /business/mention/video/list/. fields alege datele: implicit item_id și caption, plus create_time, video_link, likes, comments, shares, thumbnail_url, views, reach și creator_handle_name la cerere. sort_field acceptă CREATE_TIME, LIKES, COMMENTS sau SHARES, cu sort_type ASC sau DESC; number_of_days restrânge cele 90 de zile, regions păstrează creatorii din regiunile alese, iar cursor împreună cu has_more parcurge rezultatele pe pagini. views și reach apar null sub 1.000, iar linkurile miniaturilor expiră după 48 de ore:

Mentioned posts, sorted by likes
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
  }
}

Cum listezi comentariile care menționează contul?

Cu GET /business/mention/comment/list/, care cere și scope-ul comment.list. Implicit returnează comment_id și comment_text; item_id, video_link, caption, video_likes, thumbnail_url, commenter_display_name, comment_type, comment_create_time și comment_likes vin la cerere, iar comment_type are valoarea COMMENT sau REPLY. O pagină conține 10, dacă max_count nu cere până la 100, sortate după VIDEO_LIKES, COMMENT_CREATE_TIME sau COMMENT_LIKES. Din cauza politicilor TikTok de siguranță și încredere, o pagină poate veni scurtă, deși has_more rămâne true.

Cum răspunzi unei mențiuni?

Prin endpoint-ul de răspuns la comentarii al TikTok. POST /business/comment/reply/create/ primește business_id, video_id setat la item_id din mențiunea de comentariu, comment_id și un text de până la 1.200 de caractere, iar răspunsul apare public sub acel comentariu, pe postarea care îl conține. Referința TikTok indică scope-ul comment.list.manage și aceeași cerință de cont pentru el. Referința sa Mentions prevede un răspuns doar pentru mențiunile din comentarii.

Pot veni mențiunile prin webhook?

Da. Cu permisiunea Mentions, o aplicație apelează POST /business/webhook/update/ cu event_type BRAND_MENTION, iar TikTok trimite apoi brand.mention.event în cel mult două sau trei ore de la o mențiune, semnat în Tiktok-Signature ca celelalte webhook-uri ale sale. content este un șir JSON serializat care conține:

  • type_of_event: CREATE, EDIT sau PRIVACY_CHANGE pentru o schimbare a setării de confidențialitate a unei postări.
  • mention_type: COMMENT pentru un comentariu sau răspuns, VIDEO_MENTION pentru o legendă, unde comment_id are valoarea 0.
  • video_id, video_create_time, share_url și video_caption, care descriu postarea.
  • open_id_of_mentioned_user, unique_name_of_mentioned_user și unique_identifier, un ID al comentatorului care rămâne același în toate API-urile.
  • Detaliile vin de la /business/mention/video/get/ sau /business/mention/comment/get/, în 48 de ore de la eveniment.

Cât de des ar trebui apelate endpoint-urile Mentions?

O dată pe zi pentru fiecare endpoint și cont, după ora 7 dimineața UTC, este recomandarea TikTok. Endpoint-urile împart limitele globale de rată ale aplicației de dezvoltator, dar TikTok reîmprospătează datele din ziua precedentă între miezul nopții și ora 7 dimineața UTC, iar interogările suplimentare în aceeași zi sunt inutile. O mențiune nouă ajunge, de asemenea, în endpoint-urile de listare în aproximativ 24 până la 48 de ore, ceea ce face din webhook semnalul mai rapid.

Cum funcționează hashtag-urile de brand?

Ele extind mențiunile la postările care folosesc hashtag-uri alese de afacere. POST /business/mention/hashtag/add/ activează până la 10 hashtag-uri per cerere și 50 per cont, alese din cele până la 100 sugerate de /business/mention/hashtag/verify/list/ sau care conțin numele de utilizator complet, precum #drinktiktok pentru @TikTok. Un hashtag activat nu poate fi eliminat timp de șapte zile, iar postările sale ajung în /business/mention/hashtag/video/list/ după 24 de ore de la activare.

Ce poate face easyCoexistence cu mențiunile TikTok?

Dă propriului cod token-ul contului: get_social_credentials returnează token-ul și business_id pentru căile API for Business de sub business/, printre care business/mention/. TikTok răspunde atunci când contul și aplicația îndeplinesc cerințele de mai sus. Webhook-urile pentru mențiuni nu intră în această cale: easyCoexistence își abonează aplicația doar la evenimentele de comentarii și își rezervă căile business/webhook/, deci evenimentele BRAND_MENTION nu sunt transmise. Comentariile la postările proprii ale contului, inclusiv mențiunile, sosesc în continuare ca evenimente comment.update, pe care set_social_webhook_destination le transmite:

Comment mentions and a reply, from your own code
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!" }

Greșeli frecvente

  • Apelarea endpoint-urilor Mentions pentru un cont fără Advanced Access. TikTok le servește conturilor cu Advanced Access sau cu un cont Business verificat, lucru pe care îl arată has_advanced_access de la /business/get/.
  • Interogarea mențiunilor imediat după miezul nopții UTC. TikTok reîmprospătează datele din ziua precedentă între miezul nopții și ora 7 dimineața UTC, deci o interogare după ora 7 vede toată ziua.
  • Citirea unui comment_id de 0 drept comentariu. Într-un webhook de mențiune, înseamnă că mențiunea este în legenda postării, cu mention_type VIDEO_MENTION.
  • Activarea unui hashtag de brand ca să-l testezi. TikTok păstrează un hashtag activat șapte zile înainte să poată fi eliminat, iar el se numără în limita de 50 a contului.
Faceți acest lucru cu EasyCoexistence

US$ 9 până la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adaugi conexiuni, cu o perioadă de probă gratuită de 3 zile.

Întrebări frecvente

Poate API-ul TikTok să găsească videoclipuri care menționează contul meu?

Da, cele care îi menționează numele de utilizator cu @ în legendă. /business/mention/video/list/ returnează până la 1.000 de postări publice din ultimele 90 de zile, cu creator_handle_name care numește fiecare creator.

Se numără postările private de pe TikTok drept mențiuni?

Nu. Mentions API numără doar postările publice din ultimele 90 de zile și exclude autorii minori sau de vârstă necunoscută: 17 ani sau mai puțin în Europa, 12 ani sau mai puțin în SUA și alte regiuni.

Cât durează până apare o mențiune TikTok?

Aproximativ 24 până la 48 de ore prin endpoint-urile de listare și până la două sau trei ore prin webhook-ul Mentions.

Poate easyCoexistence să mă alerteze când contul meu TikTok este menționat?

Nu ca eveniment transmis mai departe, deoarece transmite evenimentele de comentarii TikTok, nu pe cele de mențiune. Propriul tău cod poate citi mențiunile la cerere, cu token-ul din get_social_credentials, acolo unde contul se califică.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la