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

Λίστα βίντεο λογαριασμού 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 για τις επόμενες σελίδες και τα άλλα πεδία.

20

Τον μεγαλύτερο αριθμό δημοσιεύσεων που επιστρέφει το /business/video/list/ ανά σελίδα· το max_count έχει προεπιλογή 10.

Milliseconds

Μονάδα μέτρησης του cursor, ένα UTC Unix timestamp· το endpoint επιστρέφει δημοσιεύσεις που δημοσιεύτηκαν πριν από αυτό.

item_id

Το προεπιλεγμένο πεδίο, το οποίο ένα αίτημα που δηλώνει πολλά πεδία πρέπει να περιλαμβάνει, αλλιώς ενδέχεται να προκύψει σφάλμα.

40/min

Κλήσεις που επιτρέπονται ανά εξουσιοδοτημένο λογαριασμό σε αυτό το 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:

List the latest posts
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, περικομμένο στα περιγραφικά πεδία και στις μετρήσεις:

A page from /business/video/list/
{
  "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, ακόμη και όταν υπάρχουν κι άλλες δημοσιεύσεις.

Every page, in Python
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. Ένα φιλτραρισμένο αίτημα δέχεται τα ίδια πεδία με οποιοδήποτε άλλο, οπότε μια κλήση μπορεί να επιστρέψει τις τελευταίες μετρήσεις για λίγες γνωστές δημοσιεύσεις.

The filters parameter
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:

The next page from your own code
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 επιστρέφει μόνο δημόσιες δημοσιεύσεις.
Κάντε το με EasyCoexistence

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 αφαιρεί δημοσιεύσεις που φιλτράρονται για παραβιάσεις, όπως πνευματικά δικαιώματα μουσικής.

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

Μετρικές βίντεο TikTok μέσω του API: προβολές, χρόνος θέασης και ολοκλήρωσηΜετρικές ανά βίντεο από το API for Business του TikTok: προβολές, εμβέλεια, χρόνος θέασης, ολοκλήρωση, πηγές επισκεψιμότητας και χώρες θεατών.Πώς να ανεβάσετε βίντεο στο TikTok μέσω του APIΑνεβάστε βίντεο στο TikTok με το API for Business: το publish endpoint, το JSON body, το share_id και την κλήση status, σε curl και Python.Απαντήσεις και διαχείριση σχολίων TikTok μέσω του APIΠώς το API for Business του TikTok διαβάζει, απαντά, κρύβει και διαγράφει σχόλια, και πώς οι κανόνες απαντούν αυτόματα σε νέα σχόλια.Δημογραφικά κοινού TikTok μέσω του APIΤα δημογραφικά ακολούθων που επιστρέφει το API for Business του TikTok: ηλικία, φύλο, χώρα, πόλη, ωριαία δραστηριότητα και ο κανόνας των 100 ακολούθων.Πώς ελέγχετε την κατάσταση δημοσίευσης μιας ανάρτησης στο TikTok μέσω του APIΠώς παρακολουθείτε ανάρτηση στο TikTok που δημοσιεύεται μέσω του API: share_id, PROCESSING_DOWNLOAD, PUBLISH_COMPLETE, FAILED, τα post IDs και αιτίες αποτυχίας.

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

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

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

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