tiktok/
live-ranking

Recupera con una sola chiamata la classifica giornaliera dei creator LIVE di TikTok: fino a 99 host con posizione, punteggio basato sui regali, ID utente, handle, nome visualizzato, numero di follower e link al profilo.

TikTok Live Ranking API

Nessun input richiesto
Fino a 99 host
Punteggio basato sui regali
0,5 crediti per richiesta
Pronto
Pronto

Invia la richiesta vuota. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

TikTok Live Ranking

La classifica giornaliera LIVE di TikTok mette in fila gli host delle dirette della giornata in base a un punteggio che deriva dai regali inviati dagli spettatori durante le trasmissioni, e ogni voce mostra posizione, punteggio e numero di follower dell’host. Leggerla mostra quali host il pubblico sta sostenendo oggi, come si muovono i primi posti e quali account più piccoli ricevono un sostegno superiore a quello che la dimensione del loro pubblico farebbe pensare.

Funzionalità della TikTok Live Ranking API

  • L’intera classifica, senza parametriUna richiesta non prevede input e restituisce la classifica giornaliera attuale con fino a 99 host, ciascuno con la propria posizione.
  • Punteggio accanto alla dimensione del pubblicoscore è il valore di classifica basato sui regali e followers_count il totale dei follower dell’host, così sostegno e pubblico si confrontano senza una seconda ricerca.
  • Identità dell’host su ogni rigaauthor fornisce ID utente, handle, nome visualizzato, link al profilo e avatar dell’host.

Parametri della TikTok Live Ranking API

Pronto per l’invio

Questo endpoint non richiede parametri nella richiesta. Invia l’oggetto JSON vuoto così com’è.

{}

Come usare la TikTok Live Ranking API

Invia una richiesta vuota e leggi gli host in classifica.

  1. Invia con POST {} a /v1/tiktok/live-ranking.
  2. Interroga GET /v1/tasks/{task_id} finché status è succeeded.
  3. Leggi gli host da results.items e ripassa results.next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/tiktok/live-ranking" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Each item has rank, score, author and followers_count.

Casi d’uso della TikTok Live Ranking API

  • Seguire la classifica nel corso della giornata: Recupera la classifica a orari fissi e traccia posizione e punteggio di ogni host per vedere chi sale e quando cambia l’ordine.
  • Scouting di host per agenzie e sponsor: Dividi score per followers_count per trovare gli host i cui spettatori donano molto rispetto alla dimensione del pubblico, poi inseriscili in una rosa per un ingaggio o una sponsorizzazione.

Consigli degli esperti per la TikTok Live Ranking API

  • Pianifica i recuperi ogni giorno alla stessa ora, perché un punteggio letto a mezzogiorno e uno letto a mezzanotte coprono parti diverse della stessa giornata.
  • La classifica non riporta lo stato della diretta. Abbina gli host tramite author.id e invia i loro nomi utente a TikTok User Live per vedere chi è in diretta in quel momento.

Oltre alla TikTok Live Ranking 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 Followers List API — Raccoglie i profili normalizzati visibili negli elenchi pubblici dei follower, con contesto della fonte conservato e metriche supportate.
  • TikTok Following List API — Raccoglie i profili pubblici seguiti dagli account TikTok con identità normalizzata, bio, metriche visibili e contesto dell’account di origine.
  • TikTok User Live API — Controlla se i nomi utente sono in diretta o offline e i dettagli disponibili della diretta.
  • TikTok Audience Demographics API — Mostra da quali paesi provengono i follower di un creator a partire dal nome utente, con la quota del pubblico di ogni paese.
  • TikTok Live Search API — Trova per parola chiave le dirette LIVE in onda in questo momento, con host, titoli e spettatori attuali.

Esplora altre piattaforme

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

TikTok Live Ranking API — FAQ

TikTok Live Ranking API è un’interfaccia programmatica per leggere la classifica giornaliera dei creator LIVE di TikTok, senza bisogno di input. Restituisce fino a 99 host, ciascuno con posizione, punteggio basato sui regali, ID utente, handle, nome visualizzato e numero di follower.

score è il valore in base al quale TikTok ordina gli host nella giornata, calcolato sui regali ricevuti dalle loro dirette. È un punteggio di classifica, non un compenso in una qualsiasi valuta.

Non con questo endpoint. Non prevede input e restituisce la classifica giornaliera attuale, quindi conserva copie salvate se ti serve uno storico.

Le posizioni si muovono man mano che arrivano i regali durante la giornata. Ogni recupero costa una tariffa fissa di 0,5 crediti per l’intera classifica, quindi una pianificazione oraria costa 12 crediti al giorno.

No. Mette in classifica gli host che li hanno ricevuti, con posizione, punteggio e profilo di ciascuno, e non contiene un elenco di chi ha donato.