Μπορεί το TikTok API να αναζητήσει βίντεο, hashtags ή τάσεις;
Ναι, το TikTok API μπορεί να αναζητήσει βίντεο, διαφημίσεις και τάσεις, το καθένα σε χωριστό API: το Research API αναζητά δημόσια βίντεο με λέξη-κλειδί, hashtag, όνομα χρήστη, περιοχή ή ημερομηνία, για ερευνητές που εγκρίνει η TikTok. Το Commercial Content API αναζητά διαφημίσεις με λέξη-κλειδί ή όνομα διαφημιζόμενου. Το API for Business επιστρέφει δημοφιλή hashtags, τα βίντεο που είναι τάση γι' αυτά και τις λέξεις-κλειδιά αναζήτησης που είναι σε τάση. Το Display API διαβάζει το προφίλ και τα βίντεο ενός εξουσιοδοτημένου χρήστη.
Το easyCoexistence συνδέει λογαριασμούς TikTok μέσω του API for Business, ώστε το Claude, το ChatGPT ή η δική σας πλατφόρμα να εμφανίζουν τις αναρτήσεις και τα σχόλια του λογαριασμού και να διαβάζουν τα insights του, και το get_social_credentials δίνει στον δικό σας κώδικα το token για endpoints του business/, όπως προτάσεις hashtags, με κάθε σύνδεση υπό παρακολούθηση όλο το εικοσιτετράωρο.
Επιτρεπόμενα αιτήματα Research API ανά ημέρα, για έως 100.000 εγγραφές, με την ποσόστωση να επαναφέρεται στις 12 π.μ. UTC.
Μέγιστο διάστημα μεταξύ start_date και end_date σε ένα ερώτημα βίντεο του Research API, που επιστρέφει έως 100 βίντεο ανά αίτημα.
Τα δημοφιλή hashtags /discovery/trending_list/ κατατάσσουν για μια χώρα και κατηγορία τις τελευταίες 1, 7, 30 ή 120 ημέρες.
Το /discovery/trending/search/ επιστρέφει λέξεις-κλειδιά αναζήτησης σε τάση, για λογαριασμούς με Advanced Access ή Verified Business Account.
Μέγιστο μήκος του search_term που δέχεται το Commercial Content API, το οποίο ταιριάζει ως ακριβής φράση από προεπιλογή ή ως ασαφής φράση.
Ποιο TikTok API μπορεί να κάνει αναζήτηση;
Αρκετά, σε δύο πύλες προγραμματιστών, καθεμία για διαφορετικό είδος προγραμματιστή. Το developers.tiktok.com φιλοξενεί το Research API, το Commercial Content API και το Display API. Το business-api.tiktok.com φιλοξενεί το API for Business, του οποίου τα Discovery, Accounts και Mentions endpoints καλύπτουν τις τάσεις και το περιεχόμενο του ίδιου του επιχειρηματικού λογαριασμού:
Πώς αναζητά βίντεο το Research API;
Με POST https://open.tiktokapis.com/v2/research/video/query/ και ένα client access token με το scope research.data.basic. Το αντικείμενο query συνδυάζει συνθήκες and, or και not, καθεμία μια πράξη όπως EQ ή IN σε ένα πεδίο όπως keyword, hashtag_name, username, region_code, create_date ή video_length. Τα start_date και end_date, γραμμένα ως YYYYMMDD, μπορούν να απέχουν το πολύ 30 ημέρες, και το max_count επιστρέφει έως 100 βίντεο ανά αίτημα:
curl -X POST 'https://open.tiktokapis.com/v2/research/video/query/?fields=id,video_description,create_time' \
-H 'Authorization: Bearer <CLIENT_ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"query": {
"and": [
{ "operation": "IN", "field_name": "region_code", "field_values": ["JP", "US"] },
{ "operation": "EQ", "field_name": "hashtag_name", "field_values": ["animal"] }
],
"not": [
{ "operation": "EQ", "field_name": "video_length", "field_values": ["SHORT"] }
]
},
"max_count": 100,
"start_date": "20261001",
"end_date": "20261030"
}'Τι επιστρέφει το Research API και πόσο πρόσφατα είναι τα δεδομένα;
Τα δημόσια πεδία βίντεο που ονομάζονται στο fields, όπως id, video_description, create_time, region_code, view_count, like_count, comment_count, share_count, hashtag_names και username. Το FAQ της TikTok προειδοποιεί ότι στατιστικά όπως οι προβολές και οι ακόλουθοι μπορεί να χρειαστούν έως 10 ημέρες για να ενημερωθούν, και ότι τα νέα βίντεο μπορεί να χρειαστούν έως 48 ώρες για να εμφανιστούν στην αναζήτηση. Η ημερήσια ποσόστωση είναι 1.000 αιτήματα, έως 100.000 εγγραφές σε όλα τα research APIs, με επαναφορά στις 12 π.μ. UTC.
Ποιος μπορεί να χρησιμοποιήσει το Research API;
Ερευνητές των οποίων το έργο εγκρίνει η TikTok. Ένας λογαριασμός προγραμματιστή από μόνος του δεν δίνει πρόσβαση. Η TikTok αναφέρει ακαδημαϊκά ιδρύματα στις ΗΠΑ, στον ΕΟΧ, στο Ηνωμένο Βασίλειο, στον Καναδά ή στην Ελβετία, μη κερδοσκοπικούς ή ανεξάρτητους ερευνητικούς φορείς στην ΕΕ, και ακαδημαϊκούς ή μη κερδοσκοπικούς οργανισμούς στη Βραζιλία που μελετούν την ασφάλεια των νέων στο διαδίκτυο. Οι αιτούντες πρέπει να λειτουργούν ανεξάρτητα από εμπορικά συμφέροντα, με ορισμένη ερευνητική πρόταση, δηλωμένη χρηματοδότηση και ηθική αξιολόγηση, και η TikTok συνήθως απαντά μέσα σε 4 εβδομάδες. Όταν ρωτήθηκε αν δικαιούνται δημιουργοί, διαφημιζόμενοι και εμπορικοί χρήστες, το FAQ της απαντά όχι.
Πώς αναζητά διαφημίσεις το Commercial Content API;
Με POST https://open.tiktokapis.com/v2/research/adlib/ad/query/ και το scope research.adlib.basic. Το search_term δέχεται έως 50 χαρακτήρες, που ταιριάζουν ως exact_phrase από προεπιλογή ή ως fuzzy_phrase, το οποίο βρίσκει μερικές ή όλες τις λέξεις του, με οποιαδήποτε σειρά. Τα φίλτρα περιορίζουν τα αποτελέσματα ανά ημερομηνία δημοσίευσης και χώρα-στόχο, και κάθε κλήση επιστρέφει το πολύ 10 διαφημίσεις. Η σελίδα προϊόντος της TikTok λέει ότι τα δεδομένα ξεκινούν από διαφημίσεις της ΕΕ και παραμένουν διαθέσιμα έως ένα χρόνο αφότου μια διαφήμιση προβλήθηκε τελευταία φορά. Το κοινό και οι ερευνητές σε οποιαδήποτε χώρα μπορούν να κάνουν αίτηση μέσω online φόρμας, και η TikTok αναμένει να απαντήσει μέσα σε 2 εργάσιμες ημέρες.
Ποιες τάσεις επιστρέφει το API for Business;
Αυτές των Discovery endpoints του, που διαφέρουν ανάλογα με το token που δέχονται. Το /discovery/trending_list/ κατατάσσει έως 200 δημοφιλή hashtags για μια χώρα, ΗΠΑ από προεπιλογή, και μια κατηγορία κλάδου, για 1, 7, 30 ή 120 ημέρες, με την κατάταξη, τις προβολές και τις αναρτήσεις κάθε hashtag. Το /discovery/video_list/ επιστρέφει τα 20 κορυφαία βίντεο που είναι τάση, για έως 10 από αυτά τα hashtags. Και τα δύο δέχονται advertiser_id και το access token ενός διαφημιζόμενου. Δύο ακόμη δέχονται το token ενός λογαριασμού TikTok με το scope discovery.search.words, για λογαριασμούς με Advanced Access ή Verified Business Account:
- /discovery/trending/search/: 20 λέξεις-κλειδιά αναζήτησης σε τάση στο TikTok, ή εξατομικευμένες για τον λογαριασμό με
is_personalized. - /discovery/trending/search/keyword/: 20 προτεινόμενες λέξεις-κλειδιά αναζήτησης για ερώτημα έως 255 χαρακτήρων, όπως ένα προϊόν ή μια επωνυμία.
Τι μπορεί να αναζητήσει το API ενός λογαριασμού TikTok;
Hashtags για τις λεζάντες του και αναρτήσεις που φέρουν τα hashtags της επωνυμίας του. Το GET /business/hashtag/suggestion/ δέχεται μια λέξη-κλειδί και προαιρετική γλώσσα και επιστρέφει 10 hashtags, ταξινομημένα πρώτα κατά ακριβή ταύτιση και έπειτα κατά αριθμό αναρτήσεων, με το post_count του καθενός. Το Mentions endpoint /business/mention/hashtag/video/list/ επιστρέφει έως 1.000 δημόσιες αναρτήσεις των τελευταίων 90 ημερών που χρησιμοποιούν ένα από τα hashtags της επωνυμίας που ενεργοποίησε η επιχείρηση, έως 50 από αυτές, ταξινομημένες κατά χρόνο, likes, σχόλια ή κοινοποιήσεις. Χρειάζεται το scope biz.brand.insights και λογαριασμό με Advanced Access ή Verified Business Account.
Μπορεί το Display API να αναζητήσει;
Όχι. Διαβάζει τον χρήστη που εξουσιοδότησε την εφαρμογή: το /v2/user/info/ επιστρέφει το προφίλ αυτού του χρήστη, το /v2/video/list/ τα δημόσια βίντεο του, από το νεότερο στο παλαιότερο και έως 20 ανά σελίδα, και το /v2/video/query/ συγκεκριμένα βίντεο με ID, με τα scopes user.info.basic και video.list. Κανένα από τα endpoints του δεν δέχεται λέξη-κλειδί ή hashtag.
Τι μπορεί να αναζητήσει το easyCoexistence στο TikTok;
Ό,τι απαντά το ίδιο το API του συνδεδεμένου λογαριασμού. Το list_social_posts εμφανίζει τις πρόσφατες αναρτήσεις του λογαριασμού και το list_social_comments τα σχόλια μιας ανάρτησης, ενώ ο δικός σας κώδικας καλεί μονοπάτια του API for Business κάτω από το business/ με το token από το get_social_credentials, συμπεριλαμβανομένων των προτάσεων hashtags. Τα μονοπάτια /discovery/ παίρνουν το token ενός διαφημιστή, οπότε το token του λογαριασμού δεν φτάνει σε αυτά. Τα Research και Commercial Content APIs είναι ξεχωριστά προϊόντα του developers.tiktok.com, με δική τους διαδικασία αίτησης.
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
?business_id=<BUSINESS_ID>&keyword=cold%20brew&language=en
Access-Token: <ACCESS_TOKEN>Συνηθισμένα λάθη
- Αίτηση για το Research API ώστε να παρακολουθείτε μια επωνυμία. Το FAQ της TikTok απαντά όχι στους δημιουργούς, στους διαφημιζόμενους και στους εμπορικούς χρήστες, και εγκρίνει μη εμπορικά ερευνητικά έργα.
- Αναζήτηση μεγάλης περιόδου σε μία κλήση του Research API. Το end_date μπορεί να απέχει το πολύ 30 ημέρες από το start_date, οπότε χωρίστε τις μεγαλύτερες περιόδους σε χρονικά παράθυρα.
- Ανάγνωση των προτάσεων hashtags ως τάσεων. Το /business/hashtag/suggestion/ ταξινομεί κατά ακριβή ταύτιση και αριθμό αναρτήσεων, ενώ το /discovery/trending_list/ κατατάσσει τη δημοτικότητα σε επιλεγμένη περίοδο.
- Κλήση των endpoints τάσεων αναζήτησης για προσωπικό λογαριασμό. Απαντούν για λογαριασμούς με Advanced Access ή Verified Business Account, με το discovery.search.words στο token.
US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, μειούμενο καθώς προσθέτετε συνδέσεις, με τις πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Μπορώ να αναζητήσω βίντεο TikTok με λέξη-κλειδί μέσω του API;
Ναι, με το Research API, αφού η TikTok εγκρίνει το ερευνητικό σας έργο. Το ερώτημα βίντεο δέχεται συνθήκες keyword και hashtag_name σε δημόσια βίντεο, έως 100 ανά αίτημα.
Υπάρχει TikTok API για δημοφιλή hashtags;
Ναι. Το /discovery/trending_list/ του API for Business κατατάσσει έως 200 δημοφιλή hashtags για μια χώρα και κατηγορία, με τις προβολές και τις αναρτήσεις του καθενός, για το token ενός διαφημιζόμενου.
Υπάρχει TikTok API για τα βίντεο που είναι τάση;
Ναι. Το /discovery/video_list/ του API for Business επιστρέφει τα 20 κορυφαία βίντεο που είναι τάση για έως 10 δημοφιλή hashtags, με advertiser_id και access token διαφημιζόμενου.
Μπορεί το TikTok API να βρει σχόλια που αναφέρουν τον λογαριασμό μου;
Ναι, για λογαριασμούς με Advanced Access ή Verified Business Account: το /business/mention/comment/list/ του Mentions API επιστρέφει έως 1.000 σχόλια ή απαντήσεις που κάνουν @mention στον λογαριασμό, με τα scopes biz.brand.insights και comment.list.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις