Λίστα βίντεο λογαριασμού TikTok μέσω του API
Το API for Business της TikTok εμφανίζει τις δημόσιες δημοσιεύσεις ενός λογαριασμού με GET /business/video/list/, ξεκινώντας από τις νεότερες, έως 20 ανά σελίδα. Δηλώστε τα πεδία που θέλετε να επιστρέφονται, όπως item_id, caption, share_url και video_views, και μετακινηθείτε στις σελίδες με cursor όσο το has_more είναι true. Το filters.video_ids επιλέγει συγκεκριμένες δημοσιεύσεις, και κάθε item_id είναι το ID που χρησιμοποιούν οι κλήσεις σχολίων.
Το easyCoexistence εμφανίζει τις πρόσφατες δημοσιεύσεις ενός λογαριασμού TikTok με το list_social_posts από το Claude, το ChatGPT ή τον δικό σας κώδικα, με το item_id, το caption, τον σύνδεσμο και τις μετρήσεις κάθε δημοσίευσης, και το get_social_credentials δίνει στον δικό σας κώδικα το token για τις επόμενες σελίδες και τα άλλα πεδία.
Τον μεγαλύτερο αριθμό δημοσιεύσεων που επιστρέφει το /business/video/list/ ανά σελίδα· το max_count έχει προεπιλογή 10.
Μονάδα μέτρησης του cursor, ένα UTC Unix timestamp· το endpoint επιστρέφει δημοσιεύσεις που δημοσιεύτηκαν πριν από αυτό.
Το προεπιλεγμένο πεδίο, το οποίο ένα αίτημα που δηλώνει πολλά πεδία πρέπει να περιλαμβάνει, αλλιώς ενδέχεται να προκύψει σφάλμα.
Κλήσεις που επιτρέπονται ανά εξουσιοδοτημένο λογαριασμό σε αυτό το endpoint, όπως σε κάθε endpoint του Accounts API.
Τι επιστρέφει το endpoint;
Τις δημόσιες δημοσιεύσεις του λογαριασμού: βίντεο που εμφανίζονται στο προφίλ του, φωτογραφίες και κείμενα, καθώς και τα βίντεο Only show in ads, που προβάλλονται ως διαφημίσεις χωρίς να εμφανίζονται στο προφίλ. Το media_type ξεχωρίζει το VIDEO από το PHOTO, που καλύπτει φωτογραφίες και κείμενα. Δημοσιεύσεις που το TikTok έχει φιλτράρει για παραβιάσεις, όπως πνευματικά δικαιώματα μουσικής, δεν περιλαμβάνονται στη λίστα.
Πώς γίνεται η κλήση;
Με GET και παραμέτρους URL: business_id, fields ως πίνακα JSON και, προαιρετικά, filters, cursor και max_count, το οποίο έχει προεπιλογή 10. Το token μπαίνει στην κεφαλίδα Access-Token, και η developer app σας χρειάζεται το δικαίωμα Get Account Media στο TikTok Accounts:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["item_id","create_time","media_type","caption","share_url","thumbnail_url","video_views","likes","comments","shares"]' \
--data-urlencode 'max_count=20'Ποια πεδία περιγράφουν μια δημοσίευση;
Εκτός από τις μετρήσεις, που κυμαίνονται από το video_views έως το impression_sources, η λίστα περιλαμβάνει και τα εξής, όλα κάτω από το scope video.list:
item_id: το ID της δημοσίευσης, που χρησιμοποιούν οι κλήσεις σχολίων και το filters.video_ids.media_type: VIDEO, ή PHOTO για φωτογραφία ή κείμενο.is_ad: αν η δημοσίευση χρησιμοποιείται σε διαφήμιση.create_time: πότε δημοσιεύτηκε, ως Unix δευτερόλεπτα σε UTC.- caption: η περιγραφή της δημοσίευσης, με τα hashtags.
share_url: σύνδεσμος κοινοποίησης, που συμπεριφέρεται διαφορετικά σε κινητό και υπολογιστή.embed_url: σύνδεσμος αναπαραγωγής για άλλους ιστότοπους, που δεν παίζει δημοσιεύσεις ορισμένες ως Friends ή Only you.thumbnail_url: προσωρινή εικόνα προεπισκόπησης, της οποίας η λήξη βρίσκεται στην παράμετρο x-expires.video_duration: η διάρκεια σε δευτερόλεπτα, με τρία δεκαδικά.
Πώς μοιάζει μια σελίδα αποτελεσμάτων;
Ένας πίνακας videos, με τη σειρά που τον επιστρέφει το TikTok, συν το cursor, την τιμή για την επόμενη σελίδα, και το has_more, που δείχνει αν υπάρχει επόμενη. Το create_time έρχεται ως string με Unix δευτερόλεπτα. Το παράδειγμα του TikTok, περικομμένο στα περιγραφικά πεδία και στις μετρήσεις:
{
"code": 0,
"message": "OK",
"request_id": "2021080307532501024502410704A7306F",
"data": {
"videos": [
{
"item_id": "6990565363377392901",
"create_time": "1627617835",
"caption": "little coco",
"share_url": "https://www.tiktok.com/@feather_in_the_w1nd/video/6990565363377392901?utm_campaign=tt4d_open_api&utm_source=6979330045630218242",
"likes": 10,
"comments": 2,
"shares": 0,
"video_views": 1231
}
],
"cursor": 0,
"has_more": false
}
}Πώς λειτουργεί η σελιδοποίηση;
Με βάση τον χρόνο. Το cursor έχει προεπιλογή την τρέχουσα στιγμή σε χιλιοστά του δευτερολέπτου, άρα η πρώτη σελίδα περιέχει τις νεότερες δημοσιεύσεις, και κάθε απόκριση επιστρέφει το cursor για το επόμενο αίτημα. Στείλτε το όσο το has_more είναι true. Ένα προσαρμοσμένο timestamp εμφανίζει τις δημοσιεύσεις που δημοσιεύτηκαν πριν από αυτή τη στιγμή, και οι κανόνες trust and safety του TikTok μπορούν να κάνουν μια σελίδα μικρότερη από το max_count, ακόμη και όταν υπάρχουν κι άλλες δημοσιεύσεις.
import json, requests
API = "https://business-api.tiktok.com/open_api/v1.3"
def all_posts(token: str, business_id: str, fields: list[str]):
params = {"business_id": business_id, "fields": json.dumps(fields), "max_count": 20}
while True:
r = requests.get(f"{API}/business/video/list/", headers={"Access-Token": token},
params=params, timeout=30).json()
if r["code"] != 0:
raise RuntimeError(f"{r['code']}: {r['message']}")
yield from r["data"].get("videos", [])
if not r["data"].get("has_more"):
return
params["cursor"] = r["data"]["cursor"]Πώς ανακτώνται συγκεκριμένες δημοσιεύσεις;
Με φίλτρα, σε ένα αντικείμενο JSON: το video_ids απαριθμεί τα ID των δημοσιεύσεων που θέλετε να επιστρέψει, όπως τα post_ids από την κατάσταση μιας δημοσίευσης. Το ad_post_only, που ισχύει μόνο μαζί με το video_ids, κρατά μόνο τις δημοσιεύσεις που έχουν εξουσιοδοτηθεί από διαφημιστές για Spark Ads. Ένα φιλτραρισμένο αίτημα δέχεται τα ίδια πεδία με οποιοδήποτε άλλο, οπότε μια κλήση μπορεί να επιστρέψει τις τελευταίες μετρήσεις για λίγες γνωστές δημοσιεύσεις.
filters={"video_ids":["6995316737801538821","8015388216995316737"]}Ποια όρια ισχύουν;
Το Accounts API επιτρέπει 40 κλήσεις ανά λεπτό για κάθε εξουσιοδοτημένο λογαριασμό σε αυτό το endpoint, και το σύνολο των κλήσεων Accounts API μιας εφαρμογής είναι 600 ανά λεπτό στο Basic επίπεδο και 1.000 πάνω από αυτό. Τα περιγραφικά πεδία είναι σε πραγματικό χρόνο, οι μετρήσεις συνήθως καθυστερούν 24 έως 48 ώρες, και τα δεδομένα μιας δημοσίευσης σταματούν να ενημερώνονται 365 ημέρες μετά τη δημοσίευσή της.
Πώς το easyCoexistence εμφανίζει τη λίστα των βίντεο;
Με το list_social_posts, που δέχεται το account_id και ένα προαιρετικό limit, από 1 έως 20 για το TikTok. Επιστρέφει την πρώτη σελίδα του TikTok: τις πιο πρόσφατες δημοσιεύσεις με item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments και shares, συν το cursor και το has_more. Οι επόμενες σελίδες και τα άλλα πεδία προέρχονται από τον δικό σας κώδικα, με το token και το business_id από το get_social_credentials:
GET https://business-api.tiktok.com/open_api/v1.3/business/video/list/
?business_id=<BUSINESS_ID>
&fields=["item_id","media_type","caption","embed_url"]
&cursor=1793404800000
&max_count=20
Access-Token: <ACCESS_TOKEN>Συνηθισμένα λάθη
- Ζητάτε πεδία χωρίς το item_id. Η αναφορά του TikTok προειδοποιεί ότι ένα αίτημα που δηλώνει πολλά πεδία χωρίς αυτό μπορεί να αποτύχει.
- Σταματάτε όταν μια σελίδα έρχεται μικρότερη. Το TikTok μπορεί να επιστρέψει λιγότερες από max_count δημοσιεύσεις ενώ το has_more είναι ακόμη true, οπότε ακολουθήστε το has_more.
- Αποθηκεύετε το thumbnail_url για αργότερα. Είναι προσωρινός σύνδεσμος που λήγει στην ώρα της παραμέτρου x-expires, οπότε ζητήστε νέο όταν το χρειαστείτε.
- Ψάχνετε ιδιωτικές δημοσιεύσεις στη λίστα. Το endpoint επιστρέφει μόνο δημόσιες δημοσιεύσεις.
US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με πτώση καθώς προσθέτετε συνδέσεις, και τις πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Πόσα βίντεο TikTok μπορεί να εμφανίσει το API ταυτόχρονα;
Έως 20 ανά σελίδα από το /business/video/list/. Το max_count ορίζει το μέγεθος της σελίδας και έχει προεπιλογή 10· ακολουθήστε το cursor για περισσότερα.
Το API του TikTok εμφανίζει και φωτογραφικές δημοσιεύσεις;
Ναι. Το /business/video/list/ επιστρέφει δημόσια βίντεο, φωτογραφίες και κείμενα, και το media_type ξεχωρίζει το VIDEO από το PHOTO.
Η λίστα βίντεο του TikTok περιλαμβάνει δημοσιεύσεις μόνο για διαφημίσεις;
Ναι. Το /business/video/list/ επιστρέφει επίσης τα βίντεο Only show in ads, που προβάλλονται ως διαφημίσεις χωρίς να εμφανίζονται στο προφίλ, και το is_ad δείχνει αν μια δημοσίευση χρησιμοποιείται σε διαφήμιση.
Γιατί λείπει μια δημοσίευση TikTok από τη λίστα του API;
Το endpoint εμφανίζει δημόσιες δημοσιεύσεις, και το TikTok αφαιρεί δημοσιεύσεις που φιλτράρονται για παραβιάσεις, όπως πνευματικά δικαιώματα μουσικής.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις