tiktok/
user-playlists

Elenca le playlist pubbliche sul profilo di qualsiasi creator TikTok a partire dal nome utente, con nome, link, immagine di copertina, numero di video e dati del proprietario di ogni playlist.

TikTok Playlists API

Nome utente come input
Nomi delle playlist
Numero di video per playlist
0,5 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

TikTok Playlists

Una playlist di TikTok è un gruppo con un nome che raccoglie video del creator stesso, come una storia raccontata a puntate, una serie di tutorial o una rubrica ricorrente, ed è mostrata sul suo profilo con una copertina e il numero di video. Elencarle per nome utente mostra quali serie ha organizzato un creator e quanti video contiene ciascuna.

Funzionalità della TikTok Playlists API

  • Ogni playlist pubblica di un profiloInvia un nome utente e ottieni ogni playlist pubblica come record a sé, fino a results_limit, che va da 1 a 100 e ha 20 come valore predefinito.
  • Profondità della serie in item_countitem_count è il numero di video nella playlist, così una serie di lunga durata si distingue da un raggruppamento di poche clip.
  • Titolo, copertina e link direttotitle, cover_url e l’url della playlist accompagnano ogni record, mentre author ripete id, handle e avatar del proprietario, così ogni record è autosufficiente.

Parametri della TikTok Playlists API

ParametriObbligatorioDescrizione
usernameObbligatorioIl nome utente TikTok di cui elencare le playlist, con o senza la @ iniziale.
results_limitFacoltativoQuante playlist restituire, da 1 a 100. Il valore predefinito è 20.

Come usare la TikTok Playlists API

Invia un nome utente e leggi le playlist del creator.

  1. Invia con POST {"username": "zachking"} a /v1/tiktok/user-playlists.
  2. Interroga GET /v1/tasks/{task_id} finché status è succeeded.
  3. Leggi le playlist da results.items; segui results.next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/tiktok/user-playlists" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"zachking"}'

# Each item is one playlist with title and item_count.

Casi d’uso della TikTok Playlists API

  • Confrontare i formati a serie in una nicchia: Confronta title e item_count tra i creator di una stessa categoria per vedere su quali formati a serie continuano a investire e per quante puntate li portano avanti.
  • Valutare un partner prima di un accordo ricorrente: Verifica se un potenziale collaboratore organizza già i contenuti in serie, e quanto sono lunghe, prima di proporre una collaborazione in più parti o ricorrente.

Consigli degli esperti per la TikTok Playlists API

  • Abbina le playlist tra un’istantanea e l’altra tramite id, non tramite title, perché un creator può rinominare una playlist.
  • Ordina per item_count per portare in cima le serie più lunghe di un creator prima di leggere i titoli.

Oltre alla TikTok Playlists API, usa queste API quando ti serve un altro tipo di dati pubblici di TikTok.

  • TikTok Profiles API — Recupera identità del profilo pubblico, bio, flag dell’account e conteggi del pubblico a partire dal nome utente.
  • TikTok Videos API — Recupera creator, didascalia, media, musica, tag, menzioni ed engagement dagli URL dei video.
  • TikTok User Videos API — Raccoglie i video pubblici del feed di un profilo a partire dal nome utente con didascalie, creator, media, date, engagement e contesto dell’account di origine.
  • TikTok Trending Feed API — Raccoglie il feed video pubblico attuale di una regione con creator, didascalia, copertina, data ed engagement visibile.
  • TikTok Video Transcript API — Estrae, quando disponibili, il testo della trascrizione, la lingua, il formato e il contesto della fonte dagli URL dei video pubblici.
  • TikTok Reposts API — Elenca i video di cui un account ha fatto repost, con autore originale, didascalia e numero di visualizzazioni di ciascuno.

Esplora altre piattaforme

Combina i dati di TikTok con i dati pubblici delle altre piattaforme social supportate.

TikTok Playlists API — FAQ

TikTok Playlists API è un’interfaccia programmatica per elencare, a partire dal nome utente, le playlist pubbliche sul profilo di un creator TikTok. Restituisce per ogni playlist ID, nome, link, immagine di copertina, numero di video e dati del proprietario.

No. Ogni record descrive la playlist in sé e item_count indica quanti video contiene. Per i video del creator usa TikTok User Videos.

No. Una playlist è un raggruppamento pubblico che il creator fa dei propri video sul profilo, ed è ciò che restituisce questo endpoint. Le raccolte sono cartelle personali di video salvati e non fanno parte del risultato.

Il creator non ha playlist pubbliche, un caso frequente perché TikTok riserva la creazione di playlist ai creator idonei. L’attività riesce comunque e non viene addebitato nulla; ogni playlist restituita costa 0,5 crediti.

Esegui di nuovo più tardi lo stesso nome utente e confronta item_count di ogni playlist; collected_at su ogni record data l’istantanea.