AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

TikTok-Erwähnungen über die API: Beiträge und Kommentare finden, die ein Konto erwähnen

Die Mentions API von TikTok, Teil der API for Business, liefert über GET /business/mention/video/list/ die ersten 1,000 öffentlichen Beiträge der letzten 90 Tage, deren Beschreibung das Konto mit @ erwähnt, und über /business/mention/comment/list/ die ersten 1,000 Kommentare oder Antworten mit Erwähnung. Beide Endpoints benötigen den Scope biz.brand.insights und ein Konto mit Advanced Access oder ein Verified Business Account.

easyCoexistence verbindet ein TikTok-Konto über die API for Business von TikTok: Claude, ChatGPT oder Ihr eigener Code lesen dessen Kommentare und beantworten sie mit eigenen Tools und empfangen seine Kommentar-Ereignisse, sobald sie eintreffen, und get_social_credentials gibt Ihrem eigenen Code das Token für andere API-for-Business-Aufrufe, einschließlich der Mentions-Endpoints, wo TikTok sie dem Konto öffnet.

1,000

Höchstzahl an Beiträgen mit Erwähnung, die /business/mention/video/list/ zurückgibt: alle öffentlich und aus den letzten 90 Tagen, bis zu 100 pro Anfrage.

24 to 48 hours

Ungefähre Verzögerung zwischen einer Erwähnung und ihrer Verfügbarkeit über die Mentions API.

2 to 3 hours

Latenz, die TikTok für den Mentions-Webhook angibt, nachdem ein Nutzer das Unternehmen in einer Beschreibung oder einem Kommentar erwähnt.

Once a day

Wie oft TikTok empfiehlt, jeden Mentions-Endpoint pro Konto aufzurufen, nach der Aktualisierung von 0 bis 7 Uhr UTC.

comment.list

Scope, den /business/mention/comment/list/ neben biz.brand.insights benötigt, um Kommentare mit Erwähnung zurückzugeben.

Welche Endpoints hat die Mentions API?

Sechs Lese-Endpoints, jeweils ein GET auf https://business-api.tiktok.com/open_api/v1.3, mit dem Access-Token des Kontos im Header Access-Token und seiner open_id als business_id. Zwei listen Erwähnungen auf, zwei fassen zusammen, was erwähnende Beiträge sagen, und zwei rufen eine einzelne Erwähnung ab, die ein Webhook angekündigt hat:

/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

Welche Beiträge und Kommentare zählen als Erwähnung?

Solche, die den Handle des Kontos mit @ markieren, in der Beschreibung eines Beitrags oder im Text eines Kommentars, bei einem öffentlichen Beitrag, und die die übrigen Filter von TikTok bestehen:

  • Der Beitrag wurde innerhalb der letzten 90 Tage veröffentlicht.
  • Sein Autor ist nicht minderjährig oder hat ein unbekanntes Alter: 17 oder jünger gilt in Europa als minderjährig, 12 oder jünger in den USA und anderen Regionen.
  • Er gehört zu den 1,000 meistgelikten Beiträgen oder Kommentaren, die den Handle erwähnen.
  • Die eigenen Beiträge des Unternehmens, die diese Regeln erfüllen, zählen ebenfalls.
  • Kommentare, die nur aus der Erwähnung bestehen, ohne weiteren Text, werden niedriger eingestuft.

Was braucht ein Konto, bevor es sie nutzen kann?

Ein berechtigtes Konto, eine App mit der richtigen Berechtigung, die Scopes am Token und einen Tag Wartezeit, nachdem der Inhaber die App autorisiert:

  • Advanced Access oder ein Verified Business Account; has_advanced_access auf /business/get/ zeigt, welche Konten sich qualifizieren.
  • Die Mentions-Berechtigung in der Entwickler-App, aufgeführt als Mentions, Content für Beiträge und Mentions, Comment für Kommentare.
  • biz.brand.insights am Token, plus comment.list für Kommentare mit Erwähnung.
  • 24 Stunden nach der Autorisierung, bevor der erste Abruf erfolgt, wie der Einstiegsleitfaden von TikTok verlangt.

Wie listet man Beiträge auf, die das Konto erwähnen?

Mit GET /business/mention/video/list/. fields wählt die Daten: standardmäßig item_id und caption, auf Anfrage zusätzlich create_time, video_link, likes, comments, shares, thumbnail_url, views, reach und creator_handle_name. sort_field nimmt CREATE_TIME, LIKES, COMMENTS oder SHARES mit sort_type ASC oder DESC, number_of_days grenzt die 90 Tage ein, regions beschränkt auf Creator aus den gewählten Regionen, und cursor mit has_more blättert durch die Ergebnisse. views und reach zeigen null unter 1,000, und Thumbnail-Links gelten 48 Stunden:

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
  }
}

Wie listet man Kommentare auf, die das Konto erwähnen?

Mit GET /business/mention/comment/list/, dessen Token zusätzlich comment.list braucht. Standardmäßig liefert er comment_id und comment_text; item_id, video_link, caption, video_likes, thumbnail_url, commenter_display_name, comment_type, comment_create_time und comment_likes kommen auf Anfrage, und comment_type zeigt COMMENT oder REPLY. Eine Seite enthält 10, sofern max_count nicht bis zu 100 verlangt, sortiert nach VIDEO_LIKES, COMMENT_CREATE_TIME oder COMMENT_LIKES. Wegen der Richtlinien zu Vertrauen und Sicherheit von TikTok kann eine Seite kurz ausfallen, während has_more trotzdem true ist.

Wie antwortet man auf eine Erwähnung?

Über den Antwort-Endpoint von TikTok für Kommentare. POST /business/comment/reply/create/ nimmt business_id, video_id mit dem item_id aus der Kommentar-Erwähnung, comment_id und einen text mit bis zu 1,200 Zeichen. Die Antwort erscheint öffentlich unter diesem Kommentar, auf dem Beitrag, unter dem er steht. Die Referenz von TikTok nennt den Scope comment.list.manage und dieselbe Kontovoraussetzung dafür. Ihre Erwähnungs-Referenz führt eine Antwort nur für Kommentar-Erwähnungen auf.

Können Erwähnungen per Webhook eintreffen?

Ja. Mit der Mentions-Berechtigung ruft eine App POST /business/webhook/update/ mit event_type BRAND_MENTION auf, und TikTok sendet dann brand.mention.event innerhalb von bis zu zwei oder drei Stunden nach einer Erwähnung, signiert im Header Tiktok-Signature wie die übrigen Webhooks. content ist ein serialisierter JSON-String mit:

  • type_of_event: CREATE, EDIT oder PRIVACY_CHANGE für eine Änderung der Datenschutzeinstellung eines Beitrags.
  • mention_type: COMMENT für einen Kommentar oder eine Antwort, VIDEO_MENTION für eine Beschreibung, wobei comment_id den Wert 0 hat.
  • video_id, video_create_time, share_url und video_caption, die den Beitrag beschreiben.
  • open_id_of_mentioned_user, unique_name_of_mentioned_user und unique_identifier, eine Kommentator-ID, die über alle APIs gleich bleibt.
  • Details folgen aus /business/mention/video/get/ oder /business/mention/comment/get/, innerhalb von 48 Stunden nach dem Ereignis.

Wie oft sollte man die Mentions-Endpoints aufrufen?

Einmal am Tag pro Endpoint und Konto, nach 7 Uhr UTC, empfiehlt TikTok. Die Endpoints teilen sich die globalen Rate-Limits der Entwickler-App, doch TikTok aktualisiert die Daten des Vortags zwischen Mitternacht und 7 Uhr UTC und hält weitere Abrufe am selben Tag für unnötig. Eine neue Erwähnung braucht außerdem etwa 24 bis 48 Stunden, bis sie in den Listen-Endpoints erscheint, weshalb der Webhook das schnellere Signal ist.

Wie funktionieren Marken-Hashtags?

Sie erweitern die Erwähnungen auf Beiträge, die Hashtags nutzen, die das Unternehmen gewählt hat. POST /business/mention/hashtag/add/ aktiviert bis zu 10 Hashtags pro Anfrage und 50 pro Konto, entnommen aus den bis zu 100, die /business/mention/hashtag/verify/list/ vorschlägt, oder solche, die den vollen Handle enthalten, wie #drinktiktok für @TikTok. Ein aktivierter Hashtag lässt sich sieben Tage lang nicht entfernen, und seine Beiträge sind 24 Stunden nach der Aktivierung über /business/mention/hashtag/video/list/ abrufbar.

Was kann easyCoexistence mit TikTok-Erwähnungen tun?

Übergeben Sie Ihrem eigenen Code das Token des Kontos: get_social_credentials liefert Token und business_id für Pfade der API for Business unter business/, darunter business/mention/. TikTok antwortet, wenn Konto und App die oben genannten Voraussetzungen erfüllen. Mention-Webhooks bleiben außen vor: easyCoexistence abonniert seine App nur für Kommentar-Ereignisse und behält Pfade unter business/webhook/ für sich, sodass BRAND_MENTION-Ereignisse nicht weitergeleitet werden. Kommentare zu den eigenen Beiträgen des Kontos, Erwähnungen eingeschlossen, kommen weiterhin als comment.update-Ereignisse an, die set_social_webhook_destination weiterleitet:

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!" }

Häufige Fehler

  • Die Mentions-Endpoints für ein Konto ohne Advanced Access aufrufen. TikTok stellt sie Konten mit Advanced Access oder einem Verified Business Account bereit, was has_advanced_access auf /business/get/ meldet.
  • Erwähnungen direkt nach Mitternacht UTC abrufen. TikTok aktualisiert die Daten des Vortags zwischen Mitternacht und 7 Uhr UTC, daher sieht ein Abruf nach 7 Uhr den ganzen Tag.
  • comment_id mit dem Wert 0 als Kommentar lesen. Bei einem Mention-Webhook bedeutet das, dass die Erwähnung in der Beschreibung des Beitrags steht, mit mention_type VIDEO_MENTION.
  • Einen Marken-Hashtag zum Testen aktivieren. TikTok behält einen aktivierten Hashtag sieben Tage, bevor er entfernt werden kann, und er zählt zu den 50 des Kontos.
Mit EasyCoexistence

US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit den ersten 3 Tagen kostenlos.

Häufig gestellte Fragen

Kann die TikTok API Beiträge finden, die mein Konto erwähnen?

Ja, solche, die seinen Handle mit @ in der Beschreibung nennen. /business/mention/video/list/ liefert bis zu 1,000 öffentliche Beiträge aus den letzten 90 Tagen, wobei creator_handle_name jeden Creator benennt.

Zählen private TikTok-Beiträge als Erwähnungen?

Nein. Die Mentions API berücksichtigt nur öffentliche Beiträge aus den letzten 90 Tagen und lässt Autoren aus, die minderjährig sind oder deren Alter unbekannt ist: 17 oder jünger in Europa, 12 oder jünger in den USA und anderen Regionen.

Wie lange dauert es, bis eine TikTok-Erwähnung erscheint?

Etwa 24 bis 48 Stunden über die Listen-Endpoints und bis zu zwei oder drei Stunden über den Mentions-Webhook.

Kann easyCoexistence mich benachrichtigen, wenn mein TikTok-Konto erwähnt wird?

Nicht als weitergeleitetes Ereignis, da es die Kommentar-Ereignisse von TikTok weiterleitet und keine Erwähnungs-Ereignisse. Ihr eigener Code kann Erwähnungen auf Anfrage lesen, mit dem Token aus get_social_credentials, wo das Konto sich qualifiziert.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am