AccediInizia la prova gratuita
easyCoexistence API ufficiali

Elencare i video di un account TikTok tramite l'API

L'API for Business di TikTok elenca i post pubblici di un account con GET /business/video/list/, partendo dal più recente, fino a 20 per pagina. Indica i campi da restituire, come item_id, caption, share_url e video_views, e scorri le pagine con cursor finché has_more è true. filters.video_ids seleziona post specifici, e ogni item_id è l'ID che usano le chiamate per i commenti.

easyCoexistence elenca i post recenti di un account TikTok con list_social_posts da Claude, ChatGPT o dal tuo codice, con item_id, didascalia, link e conteggi di ciascun post, e get_social_credentials fornisce al tuo codice il token per le pagine successive e gli altri campi.

20

Il numero massimo di post che /business/video/list/ restituisce per pagina; max_count vale 10 per impostazione predefinita.

Milliseconds

Unità del cursor: un timestamp Unix in UTC; l'endpoint restituisce i post pubblicati prima di esso.

item_id

Il campo predefinito, che una richiesta con più campi deve includere, altrimenti può verificarsi un errore.

40/min

Chiamate consentite per account autorizzato su questo endpoint, come su ogni endpoint dell'Accounts API.

Cosa restituisce l'endpoint?

I post pubblici dell'account: i video mostrati sul suo profilo, i post con foto e testo, e i video Only show in ads, che vengono usati come annunci senza comparire sul profilo. media_type distingue VIDEO da PHOTO, che copre i post con foto e testo. I post che TikTok ha filtrato per violazioni, come quelle sul copyright musicale, sono esclusi dall'elenco.

Come si effettua la chiamata?

Con una GET e parametri nell'URL: business_id, fields come array JSON e, facoltativamente, filters, cursor e max_count, che vale 10 per impostazione predefinita. Il token va nell'header Access-Token, e l'app per sviluppatori richiede il permesso Get Account Media in 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'

Quali campi descrivono un post?

Oltre alle metriche, che vanno da video_views a impression_sources, l'elenco include questi campi, tutti sotto lo scope video.list:

  • item_id: l'ID del post, usato dalle chiamate sui commenti e da filters.video_ids.
  • media_type: VIDEO, oppure PHOTO per un post con foto o testo.
  • is_ad: indica se il post è usato in un annuncio.
  • create_time: quando il post è stato pubblicato, in secondi Unix in UTC.
  • caption: la descrizione del post, hashtag inclusi.
  • share_url: un link condivisibile, che si comporta in modo diverso su mobile e desktop.
  • embed_url: un link al player per altri siti, che non riproduce i post impostati su Friends o Only you.
  • thumbnail_url: un'anteprima temporanea la cui scadenza è nel parametro x-expires.
  • video_duration: la durata in secondi, con tre decimali.

Come appare una pagina di risultati?

Un array videos nell'ordine in cui lo restituisce TikTok, più cursor, il valore da inviare per la pagina successiva, e has_more, che indica se ce n'è una. create_time arriva come stringa di secondi Unix. Ecco l'esempio di TikTok, ridotto ai campi descrittivi e ai conteggi:

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

Come funziona la paginazione?

Per tempo. cursor vale per impostazione predefinita il momento attuale in millisecondi, quindi la prima pagina contiene i post più recenti, e ogni risposta restituisce il cursor per la richiesta successiva. Passalo finché has_more è true. Un timestamp personalizzato elenca i post pubblicati prima di quel momento, e le regole di fiducia e sicurezza di TikTok possono rendere una pagina più corta di max_count anche quando restano altri post.

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"]

Come si recuperano post specifici?

Con filters, un oggetto JSON: video_ids elenca gli ID dei post da restituire, come i post_ids di uno stato di pubblicazione. ad_post_only, valido solo accanto a video_ids, mantiene solo i post autorizzati agli inserzionisti per Spark Ads. Una richiesta filtrata accetta gli stessi campi di qualunque altra, quindi una sola chiamata può restituire gli ultimi dati per alcuni post noti.

The filters parameter
filters={"video_ids":["6995316737801538821","8015388216995316737"]}

Quali limiti si applicano?

L'Accounts API consente 40 chiamate al minuto per ogni account autorizzato su questo endpoint, e le chiamate all'Accounts API di un'app contano complessivamente 600 al minuto con il livello Basic e 1.000 oltre. I campi descrittivi sono in tempo reale, mentre i conteggi di solito hanno un ritardo da 24 a 48 ore, e i dati di un post smettono di aggiornarsi 365 giorni dopo la pubblicazione.

Come elenca i video easyCoexistence?

Con list_social_posts, che richiede account_id e un limite facoltativo, da 1 a 20 per TikTok. Restituisce la prima pagina di TikTok: i post più recenti con item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments e shares, più cursor e has_more. Le pagine successive e gli altri campi si ottengono dal tuo codice, con il token e il business_id di 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>

Errori comuni

  • Richiedere campi senza item_id. Il riferimento di TikTok avverte che una richiesta con più campi senza di esso può fallire.
  • Fermarsi quando una pagina torna corta. TikTok può restituire meno di max_count post mentre has_more è ancora true, quindi segui has_more.
  • Conservare thumbnail_url per dopo. È un link temporaneo che scade al momento indicato nel parametro x-expires, quindi recuperane uno nuovo quando serve.
  • Cercare post privati nell'elenco. L'endpoint restituisce solo post pubblici.
Farlo con EasyCoexistence

Da US$ 9 a US$ 0,75 per connessione al mese, con il calo man mano che aggiungi connessioni, e con i primi 3 giorni di prova gratuita.

Domande frequenti

Quanti video TikTok può elencare l'API in una sola volta?

Fino a 20 per pagina da /business/video/list/. max_count imposta la dimensione della pagina e vale 10 per impostazione predefinita; segui cursor per averne altri.

L'API di TikTok elenca anche i post con foto?

Sì. /business/video/list/ restituisce i post pubblici con video, foto e testo, e media_type distingue VIDEO da PHOTO.

L'elenco video di TikTok include anche i post solo pubblicitari?

Sì. /business/video/list/ restituisce anche i video Only show in ads, che vengono usati come annunci senza comparire sul profilo, e is_ad indica se un post è usato in un annuncio.

Perché un post TikTok manca nell'elenco dell'API?

L'endpoint elenca solo post pubblici, e TikTok esclude i post filtrati per violazioni, come quelle sul copyright musicale.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il