ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Το Mentions API του TikTok: εύρεση posts και σχολίων που αναφέρουν έναν λογαριασμό

Το Mentions API του TikTok, μέρος του API for Business, επιστρέφει τα 1.000 κορυφαία δημόσια posts των τελευταίων 90 ημερών που αναφέρουν έναν λογαριασμό επιχείρησης με @ στη λεζάντα τους, μέσω του GET /business/mention/video/list/, και τα 1.000 κορυφαία σχόλια ή απαντήσεις που τον αναφέρουν, μέσω του /business/mention/comment/list/. Και τα δύο χρειάζονται το scope biz.brand.insights και λογαριασμό με Advanced Access ή Verified Business Account.

Το easyCoexistence συνδέει έναν λογαριασμό TikTok μέσω του API for Business του TikTok: το Claude, το ChatGPT ή ο δικός σας κώδικας διαβάζουν τα σχόλιά του και απαντούν σε αυτά με ειδικά εργαλεία και λαμβάνουν τα συμβάντα σχολίων καθώς φτάνουν, και το get_social_credentials δίνει στον δικό σας κώδικα το token για άλλες κλήσεις του API for Business, συμπεριλαμβανομένων των endpoints Mentions όπου το TikTok τα ανοίγει στον λογαριασμό.

1,000

Μέγιστος αριθμός posts που επιστρέφει το /business/mention/video/list/, όλα δημόσια και των τελευταίων 90 ημερών, έως 100 ανά αίτημα.

24 to 48 hours

Κατά προσέγγιση καθυστέρηση μεταξύ της αναφοράς και της διαθεσιμότητάς της στο Mentions API.

2 to 3 hours

Η καθυστέρηση που δίνει το TikTok για το webhook αναφορών μετά από αναφορά του λογαριασμού σε λεζάντα ή σχόλιο.

Once a day

Πόσο συχνά συνιστά το TikTok την κλήση κάθε endpoint αναφορών ανά λογαριασμό, μετά την ανανέωση μεταξύ 0 και 7 π.μ. UTC.

comment.list

Το scope που χρειάζεται το /business/mention/comment/list/, πέρα από το biz.brand.insights, για να επιστρέφει σχόλια που αναφέρουν τον λογαριασμό.

Ποια endpoints έχει το Mentions API;

Έξι endpoints ανάγνωσης, καθένα ως GET στο https://business-api.tiktok.com/open_api/v1.3, με το access token του λογαριασμού στην κεφαλίδα Access-Token και το open_id του ως business_id. Δύο εμφανίζουν λίστες αναφορών, δύο συνοψίζουν τι λένε τα posts με αναφορές, και δύο ανακτούν μία μεμονωμένη αναφορά που ανακοίνωσε ένα 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

Ποια posts και σχόλια μετρούν ως αναφορές;

Εκείνα που επισημαίνουν το handle του λογαριασμού με @, στη λεζάντα ενός post ή στο κείμενο ενός σχολίου, σε δημόσιο post, και που περνούν τα υπόλοιπα φίλτρα του TikTok:

  • Το post ανέβηκε εντός των τελευταίων 90 ημερών.
  • Ο δημιουργός του δεν είναι ανήλικος ή άγνωστης ηλικίας: το 17 ή κάτω μετράει ως ανήλικο στην Ευρώπη, το 12 ή κάτω στις ΗΠΑ και σε άλλες περιοχές.
  • Κατατάσσεται ανάμεσα στα 1.000 πιο αγαπημένα posts ή σχόλια που αναφέρουν το handle.
  • Τα posts της ίδιας της επιχείρησης που πληρούν αυτούς τους κανόνες μετράνε επίσης.
  • Τα σχόλια που αποτελούνται μόνο από την αναφορά, χωρίς άλλο κείμενο, κατατάσσονται χαμηλότερα.

Τι χρειάζεται ένας λογαριασμός πριν τα χρησιμοποιήσει;

Έναν επιλέξιμο λογαριασμό, μια εφαρμογή με τη σωστή άδεια, τα scopes στο token και μία μέρα αναμονής αφού ο ιδιοκτήτης εξουσιοδοτήσει την εφαρμογή:

  • Advanced Access ή Verified Business Account. Το has_advanced_access στο /business/get/ δείχνει ποιοι λογαριασμοί πληρούν τις προϋποθέσεις.
  • Η άδεια Mentions στην εφαρμογή προγραμματιστή, με την ονομασία Mentions, Content για τα posts και Mentions, Comment για τα σχόλια.
  • biz.brand.insights στο access token, και comment.list για αναφορές σε σχόλια.
  • 24 ώρες μετά την εξουσιοδότηση πριν από την πρώτη ανάκτηση, όπως ζητά ο οδηγός εκκίνησης του TikTok.

Πώς παίρνετε τη λίστα των posts που αναφέρουν τον λογαριασμό;

Με GET /business/mention/video/list/. Το fields ορίζει τα δεδομένα: item_id και caption από προεπιλογή, και επιπλέον τα create_time, video_link, likes, comments, shares, thumbnail_url, views, reach και creator_handle_name κατόπιν αιτήματος. Το sort_field δέχεται CREATE_TIME, LIKES, COMMENTS ή SHARES με sort_type ASC ή DESC, το number_of_days περιορίζει τις 90 ημέρες, το regions κρατά δημιουργούς από επιλεγμένες περιοχές, και το cursor με το has_more σελιδοποιεί τα αποτελέσματα. Τα views και reach επιστρέφουν null κάτω από 1.000, και οι σύνδεσμοι thumbnail ισχύουν 48 ώρες:

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

Πώς παίρνετε τη λίστα των σχολίων που αναφέρουν τον λογαριασμό;

Με GET /business/mention/comment/list/, του οποίου το token χρειάζεται επιπλέον το comment.list. Από προεπιλογή επιστρέφει comment_id και comment_text. Τα item_id, video_link, caption, video_likes, thumbnail_url, commenter_display_name, comment_type, comment_create_time και comment_likes έρχονται κατόπιν αιτήματος, και το comment_type παίρνει τιμή COMMENT ή REPLY. Μία σελίδα περιέχει 10, εκτός αν το max_count ζητά έως 100, ταξινομημένα κατά VIDEO_LIKES, COMMENT_CREATE_TIME ή COMMENT_LIKES. Λόγω των πολιτικών εμπιστοσύνης και ασφάλειας του TikTok, μια σελίδα μπορεί να έρθει με λιγότερα αποτελέσματα ενώ το has_more παραμένει true.

Πώς απαντάτε σε μια αναφορά;

Μέσω του endpoint απάντησης σε σχόλια του TikTok. Το POST /business/comment/reply/create/ δέχεται business_id, video_id ίσο με το item_id από την αναφορά σχολίου, comment_id και text έως 1.200 χαρακτήρες, και η απάντηση εμφανίζεται δημόσια κάτω από εκείνο το σχόλιο, σε όποιο post κι αν βρίσκεται. Η αναφορά του TikTok ονομάζει το scope comment.list.manage και την ίδια απαίτηση λογαριασμού γι' αυτό. Η σελίδα αναφορών του Mentions αναφέρει απάντηση μόνο για αναφορές σε σχόλια.

Μπορούν οι αναφορές να φτάνουν μέσω webhook;

Ναι. Με την άδεια Mentions, μια εφαρμογή καλεί το POST /business/webhook/update/ με event_type BRAND_MENTION, και το TikTok στέλνει τότε brand.mention.event εντός δύο έως τριών ωρών από μια αναφορά, υπογεγραμμένο στην κεφαλίδα Tiktok-Signature όπως τα άλλα webhooks του. Το content είναι μια σειριοποιημένη συμβολοσειρά JSON που περιέχει:

  • type_of_event: CREATE, EDIT ή PRIVACY_CHANGE για αλλαγή της ρύθμισης απορρήτου ενός post.
  • mention_type: COMMENT για σχόλιο ή απάντηση, VIDEO_MENTION για λεζάντα, όπου το comment_id είναι 0.
  • video_id, video_create_time, share_url και video_caption, που περιγράφουν το post.
  • open_id_of_mentioned_user, unique_name_of_mentioned_user και unique_identifier, ένα ID σχολιαστή που μένει το ίδιο σε όλα τα API.
  • Οι λεπτομέρειες προκύπτουν από το /business/mention/video/get/ ή το /business/mention/comment/get/, εντός 48 ωρών από το συμβάν.

Πόσο συχνά πρέπει να καλούνται τα endpoints αναφορών;

Μία φορά την ημέρα ανά endpoint και λογαριασμό, μετά τις 7 π.μ. UTC, είναι η συμβουλή του TikTok. Τα endpoints μοιράζονται τα global rate limits της εφαρμογής προγραμματιστή, όμως το TikTok ανανεώνει τα δεδομένα της προηγούμενης ημέρας μεταξύ μεσάνυχτων και 7 π.μ. UTC, και κρίνει περιττές τις επιπλέον ανακτήσεις εντός της ίδιας ημέρας. Μια νέα αναφορά χρειάζεται επίσης περίπου 24 έως 48 ώρες για να φτάσει στα endpoints λίστας, γι' αυτό το webhook είναι το γρηγορότερο σήμα.

Πώς λειτουργούν τα hashtags της επιχείρησης;

Διευρύνουν τις αναφορές σε posts που χρησιμοποιούν hashtags που επέλεξε η επιχείρηση. Το POST /business/mention/hashtag/add/ ενεργοποιεί έως 10 hashtags ανά αίτημα και 50 ανά λογαριασμό, επιλεγμένα από τα έως 100 που προτείνει το /business/mention/hashtag/verify/list/ ή που περιέχουν ολόκληρο το handle, όπως το #drinktiktok για το @TikTok. Ένα ενεργοποιημένο hashtag δεν μπορεί να αφαιρεθεί για επτά ημέρες, και τα posts του φτάνουν στο /business/mention/hashtag/video/list/ 24 ώρες αφού ενεργοποιηθεί.

Τι μπορεί να κάνει το easyCoexistence με τις αναφορές του TikTok;

Δώστε στον δικό σας κώδικα το token του λογαριασμού: το get_social_credentials επιστρέφει το token και το business_id για διαδρομές του API for Business κάτω από business/, μεταξύ των οποίων και business/mention/. Το TikTok απαντά όταν ο λογαριασμός και η εφαρμογή πληρούν τις παραπάνω απαιτήσεις. Τα webhooks αναφορών μένουν έξω από αυτό: το easyCoexistence εγγράφει την εφαρμογή του μόνο σε συμβάντα σχολίων και κρατά τις διαδρομές business/webhook/ για τον εαυτό του, οπότε τα συμβάντα BRAND_MENTION δεν προωθούνται. Τα σχόλια στα δικά του posts του λογαριασμού, συμπεριλαμβανομένων των αναφορών, εξακολουθούν να φτάνουν ως συμβάντα comment.update, τα οποία προωθεί το set_social_webhook_destination:

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

Συνηθισμένα λάθη

  • Κλήση των endpoints αναφορών για λογαριασμό χωρίς Advanced Access. Το TikTok τα προσφέρει μόνο σε λογαριασμούς με Advanced Access ή Verified Business Account, κάτι που δείχνει το has_advanced_access στο /business/get/.
  • Ανάκτηση αναφορών αμέσως μετά τα μεσάνυχτα UTC. Το TikTok ανανεώνει τα δεδομένα της προηγούμενης ημέρας μεταξύ μεσάνυχτων και 7 π.μ. UTC, οπότε μια ανάκτηση μετά τις 7 π.μ. βλέπει ολόκληρη την ημέρα.
  • Ανάγνωση του comment_id 0 ως σχολίου. Σε webhook αναφοράς σημαίνει ότι η αναφορά βρίσκεται στη λεζάντα του post, με mention_type VIDEO_MENTION.
  • Ενεργοποίηση hashtag για δοκιμή. Το TikTok κρατά ένα ενεργοποιημένο hashtag για επτά ημέρες πριν μπορεί να αφαιρεθεί, και μετράει προς το όριο των 50 του λογαριασμού.
Κάντε το με EasyCoexistence

Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με πτώση καθώς προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Μπορεί το API του TikTok να βρει βίντεο που αναφέρουν τον λογαριασμό μου;

Ναι, εκείνα που αναφέρουν το handle του με @ στη λεζάντα. Το /business/mention/video/list/ επιστρέφει έως 1.000 δημόσια posts των τελευταίων 90 ημερών, με το creator_handle_name να ονομάζει κάθε δημιουργό.

Μετρούν ως αναφορές τα ιδιωτικά posts του TikTok;

Όχι. Το Mentions API μετρά μόνο δημόσια posts των τελευταίων 90 ημερών και αφήνει εκτός δημιουργούς ανήλικους ή άγνωστης ηλικίας: το 17 ή κάτω στην Ευρώπη, το 12 ή κάτω στις ΗΠΑ και σε άλλες περιοχές.

Πόσο χρόνο χρειάζεται για να εμφανιστεί μια αναφορά στο TikTok;

Περίπου 24 έως 48 ώρες μέσω των endpoints λίστας, και έως δύο ή τρεις ώρες μέσω του webhook αναφορών.

Μπορεί το easyCoexistence να με ειδοποιεί όταν αναφέρεται ο λογαριασμός μου στο TikTok;

Όχι ως προωθημένο συμβάν, αφού προωθεί τα συμβάντα σχολίων του TikTok και όχι τα συμβάντα αναφορών. Ο δικός σας κώδικας μπορεί να διαβάζει αναφορές κατόπιν αιτήματος, με το token από το get_social_credentials, όπου ο λογαριασμός πληροί τις προϋποθέσεις.

Συνεχίστε την ανάγνωση

Απαντήσεις και διαχείριση σχολίων TikTok μέσω του APIΠώς το API for Business του TikTok διαβάζει, απαντά, κρύβει και διαγράφει σχόλια, και πώς οι κανόνες απαντούν αυτόματα σε νέα σχόλια.Επαλήθευση webhooks του TikTok: η κεφαλίδα υπογραφής και ο τρόπος ελέγχου τηςΕπαλήθευση webhook του TikTok API for Business: κεφαλίδα Tiktok-Signature, HMAC-SHA256 και μυστικό της εφαρμογής, σε Node.js.Όρια κλήσεων TikTok API: ανά endpoint, εφαρμογή και λογαριασμόΌρια κλήσεων του TikTok API: 40 κλήσεις το λεπτό ανά λογαριασμό και endpoint, 600 ή 1.000 ανά εφαρμογή στο Accounts API και τα τέσσερα επίπεδα.Scopes του TikTok API for Business: τι ξεκλειδώνει κάθε δικαίωμαΤα δικαιώματα του Accounts API του TikTok με τα δικά του ονόματα: τι ξεκλειδώνει το καθένα, τα scopes ανά πεδίο και πώς ελέγχετε ένα token.Απαντήσεις AI σε σχόλια TikTokΤο AI της ίδιας της επιχείρησης απαντά δημόσια σε σχόλια TikTok: αυτοματισμοί, απαντήσεις έως 150 χαρακτήρες και κανόνες λέξεων-κλειδιών.Συμβάντα webhook σχολίων της TikTokΠώς το webhook comment.update της TikTok αναφέρει σχόλια και απαντήσεις, τι περιέχει κάθε συμβάν και πώς φτάνει υπογεγραμμένο στο endpoint σας.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις