Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

TikTok mention'ları API üzerinden: hesabı etiketleyen gönderi ve yorumları bulma

TikTok Mentions API, API for Business'ın parçası olarak, GET /business/mention/video/list/ üzerinden, son 90 gün içinde açıklamasında hesabı @ ile etiketleyen en öne çıkan 1.000 herkese açık gönderiyi döndürür. /business/mention/comment/list/ üzerinden ise bu hesabı etiketleyen en öne çıkan 1.000 yorum veya yanıtı döndürür. İkisi de biz.brand.insights kapsamını ve Advanced Access ya da Verified Business Account'a sahip bir hesabı gerektirir.

easyCoexistence, TikTok hesabını API for Business üzerinden bağlar: Claude, ChatGPT ya da kendi kodunuz yorumları özel araçlarla okur ve yanıtlar, yorum olaylarını geldikçe alır; get_social_credentials ise kendi kodunuza, TikTok'un erişim verdiği durumlarda Mentions uç noktaları dahil, diğer API for Business çağrıları için token'ı verir.

1,000

En çok etiketlenen gönderiler: /business/mention/video/list/ tarafından döndürülür, hepsi herkese açık ve son 90 gün içindedir, istek başına en fazla 100 adet.

24 to 48 hours

Bir mention'ın yapılması ile Mentions API üzerinden erişilebilir olması arasındaki yaklaşık gecikme.

2 to 3 hours

Bir kullanıcı açıklamada veya yorumda işletmeyi etiketledikten sonra TikTok'un Mentions webhook'u için verdiği gecikme süresi.

Once a day

UTC 00:00 ile 07:00 arasındaki yenilemeden sonra, her hesap için Mentions uç noktalarının TikTok tarafından önerilen çağrı sıklığı.

comment.list

/business/mention/comment/list/ kapsamının, hesabı etiketleyen yorumları döndürmek için biz.brand.insights'a ek olarak gerektirdiği kapsam.

Mentions API hangi uç noktalara sahip?

Altı okuma uç noktası; her biri https://business-api.tiktok.com/open_api/v1.3 adresine yapılan bir GET isteğidir. Hesabın erişim token'ı Access-Token başlığında, open_id değeri ise business_id olarak gönderilir. İkisi mention'ları listeler, ikisi etiketlenen gönderilerin ne dediğini özetler, ikisi ise bir webhook'un bildirdiği tek bir mention'ı getirir:

/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

Hangi gönderi ve yorumlar mention sayılır?

Hesabın kullanıcı adını @ ile etiketleyen, gönderinin açıklamasında veya yorumun metninde yer alan, herkese açık olan ve TikTok'un diğer filtrelerinden geçen gönderi ve yorumlar:

  • Gönderi son 90 gün içinde paylaşılmış olmalı.
  • Yazarı reşit değil ya da yaşı bilinmiyor olmamalı: Avrupa'da 17 yaş ve altı, ABD'de ve diğer bölgelerde 12 yaş ve altı reşit değil sayılır.
  • Hesabı etiketleyen en çok beğenilen 1.000 gönderi veya yorum arasında yer almalı.
  • İşletmenin, bu kurallara uyan kendi gönderileri de sayılır.
  • Yalnızca etiketten oluşan ve başka metni olmayan yorumlar daha düşük sıralanır.

Hesap bunları kullanabilmek için neye ihtiyaç duyar?

Uygun bir hesap, doğru izne sahip bir uygulama, erişim token'ında gerekli kapsamlar ve hesap sahibi uygulamayı yetkilendirdikten sonra bir gün beklemek:

  • Advanced Access veya Verified Business Account; /business/get/ üzerindeki has_advanced_access, hangi hesapların uygun olduğunu gösterir.
  • Geliştirici uygulamasında Mentions izni: gönderiler için Mentions, Content; yorumlar için Mentions, Comment olarak listelenir.
  • Erişim token'ında biz.brand.insights, yorum mention'ları için ise ayrıca comment.list bulunmalıdır.
  • TikTok'un başlangıç rehberinin istediği üzere, ilk çekimden önce yetkilendirmeden sonra 24 saat beklenir.

Hesabı etiketleyen gönderiler nasıl listelenir?

GET /business/mention/video/list/ ile. fields, varsayılan olarak item_id ve caption değerlerini seçer; isteğe bağlı olarak create_time, video_link, likes, comments, shares, thumbnail_url, views, reach ve creator_handle_name da eklenebilir. sort_field, CREATE_TIME, LIKES, COMMENTS veya SHARES alır; sort_type ile ASC ya da DESC seçilir. number_of_days 90 günü daraltır, regions seçilen bölgelerdeki içerik üreticilerini tutar, cursor ve has_more ile sonuçlar sayfalanır. views ve reach değerleri 1.000'in altında null döner, küçük resim bağlantıları ise 48 saat geçerlidir:

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

Hesabı etiketleyen yorumlar nasıl listelenir?

GET /business/mention/comment/list/ ile; bu token'ın ayrıca comment.list kapsamına sahip olması gerekir. Varsayılan olarak comment_id ve comment_text döner; item_id, video_link, caption, video_likes, thumbnail_url, commenter_display_name, comment_type, comment_create_time ve comment_likes isteğe bağlı gelir. comment_type değeri COMMENT ya da REPLY'dir. Sayfada varsayılan 10 kayıt bulunur; max_count ile 100'e kadar istenebilir ve VIDEO_LIKES, COMMENT_CREATE_TIME veya COMMENT_LIKES ile sıralanır. TikTok'un güven ve güvenlik politikaları nedeniyle, has_more hâlâ true iken bir sayfa daha az kayıtla dönebilir.

Bir mention'a nasıl yanıt verilir?

TikTok'un yorum yanıt uç noktası üzerinden. POST /business/comment/reply/create/, business_id, yorum mention'ındaki item_id değerine eşit video_id, comment_id ve en fazla 1.200 karakterlik bir text alır. Yanıt, yorumun bulunduğu gönderide, o yorumun altında herkese açık görünür. TikTok'un referansı comment.list.manage kapsamını ve bu kapsam için aynı hesap gereksinimini belirtir. Mentions referansı yalnızca yorum mention'ları için yanıtı listeler.

Mention'lar webhook ile gelebilir mi?

Evet. Mentions izniyle bir uygulama, event_type BRAND_MENTION değeriyle POST /business/webhook/update/ çağrısı yapar. TikTok da bir mention'dan sonra en fazla iki ila üç saat içinde brand.mention.event gönderir ve bunu diğer webhook'ları gibi Tiktok-Signature başlığıyla imzalar. content, şu alanları içeren serileştirilmiş bir JSON dizesidir:

  • type_of_event: Bir gönderinin gizlilik ayarındaki değişiklik için CREATE, EDIT veya PRIVACY_CHANGE.
  • mention_type: Bir yorum ya da yanıt için COMMENT, açıklama için VIDEO_MENTION; bu durumda comment_id 0 değerini alır.
  • video_id, video_create_time, share_url ve video_caption; gönderiyi tanımlar.
  • open_id_of_mentioned_user, unique_name_of_mentioned_user ve unique_identifier; unique_identifier, API'ler arasında değişmeyen bir yorum yapan kimliğidir.
  • Ayrıntılar, olaydan sonraki 48 saat içinde /business/mention/video/get/ veya /business/mention/comment/get/ üzerinden alınır.

Mentions uç noktaları ne sıklıkla çağrılmalı?

TikTok'un önerisi, her uç nokta ve hesap için günde bir kez, UTC 07:00'den sonra çağrı yapılmasıdır. Uç noktalar geliştirici uygulamasının genel hız sınırlarını paylaşır; ancak TikTok, bir önceki günün verilerini UTC 00:00 ile 07:00 arasında yeniler ve aynı gün içinde yapılan ek çekimleri gereksiz görür. Yeni bir mention, liste uç noktalarına ulaşmak için yaklaşık 24 ila 48 saat alır; bu nedenle webhook daha hızlı bir sinyaldir.

Marka hashtag'leri nasıl çalışır?

Bunlar mention'ları, işletmenin seçtiği hashtag'leri kullanan gönderilere genişletir. POST /business/mention/hashtag/add/ istek başına en fazla 10, hesap başına 50 hashtag'i etkinleştirir. Bu hashtag'ler, /business/mention/hashtag/verify/list/ uç noktasının önerdiği en fazla 100 hashtag'ten alınır ya da @TikTok için #drinktiktok gibi tam kullanıcı adını içerir. Etkinleştirilen bir hashtag yedi gün boyunca kaldırılamaz; gönderileri, etkinleştirildikten 24 saat sonra /business/mention/hashtag/video/list/ uç noktasında görünür.

easyCoexistence TikTok mention'ları ile ne yapabilir?

Hesabın token'ını kendi kodunuza verin: get_social_credentials, business/mention/ dahil business/ altındaki API for Business yolları için token ve business_id döndürür. Hesap ve uygulama yukarıdaki gereksinimleri karşıladığında TikTok yanıt verir. Mention webhook'ları bu kapsamın dışındadır: easyCoexistence uygulamasına yalnızca yorum olaylarına abone olur ve business/webhook/ yollarını kendi kullanımında tutar; bu nedenle BRAND_MENTION olayları iletilmez. Hesabın kendi gönderilerindeki yorumlar, mention'lar dahil, yine comment.update olayları olarak gelir ve bunlar set_social_webhook_destination ile iletilir:

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

Yaygın hatalar

  • Advanced Access olmayan bir hesap için Mentions uç noktalarını çağırmak. TikTok bunları yalnızca Advanced Access veya Verified Business Account'a sahip hesaplara sunar; /business/get/ üzerindeki has_advanced_access bunu bildirir.
  • UTC gece yarısından hemen sonra mention'ları çekmek. TikTok bir önceki günün verilerini UTC 00:00 ile 07:00 arasında yeniler; 07:00'den sonraki bir çekim tüm günü görür.
  • Webhook'taki comment_id 0 değerini bir yorum olarak okumak. Bir mention webhook'unda bu, mention'ın gönderinin açıklamasında olduğu ve mention_type değerinin VIDEO_MENTION olduğu anlamına gelir.
  • Denemek için bir marka hashtag'ini etkinleştirmek. TikTok, etkinleştirilen bir hashtag'i yedi gün boyunca tutar, kaldıramazsınız ve hesabın 50 sınırına sayılır.
Bunu EasyCoexistence'la yapmak

Bağlantı başına aylık US$ 9'dan US$ 0,75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsizdir.

Sık sorulan sorular

TikTok API hesabımı etiketleyen videoları bulabilir mi?

Evet; açıklamasında hesabın kullanıcı adını @ ile etiketleyen videoları bulabilir. /business/mention/video/list/ son 90 günün en fazla 1.000 herkese açık gönderisini döndürür; her içerik üreticisi creator_handle_name ile adıyla belirtilir.

Özel TikTok gönderileri mention sayılır mı?

Hayır. Mentions API yalnızca son 90 günün herkese açık gönderilerini sayar; reşit olmayan ya da yaşı bilinmeyen yazarları dışarıda bırakır: Avrupa'da 17 yaş ve altı, ABD'de ve diğer bölgelerde 12 yaş ve altı.

Bir TikTok mention'ı görünmesi ne kadar sürer?

Liste uç noktaları üzerinden yaklaşık 24 ila 48 saat, Mentions webhook'u üzerinden ise en fazla iki ila üç saat.

easyCoexistence TikTok hesabım etiketlendiğinde uyarı verebilir mi?

İletilen bir olay olarak değil, çünkü easyCoexistence TikTok'un yorum olaylarını iletir, mention olaylarını iletmez. Kendi kodunuz, hesabın uygun olduğu durumlarda mention'ları get_social_credentials'tan aldığı token ile istek üzerine okuyabilir.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi