tiktok-creative-center/
trending-hashtags

Ottieni la classifica degli hashtag di tendenza in un paese sul TikTok Creative Center, con numero di post e visualizzazioni e una curva di popolarità giornaliera su 7, 30 o 90 giorni.

TikTok Creative Center Trending Hashtags API

Classifiche per paese
7, 30 o 90 giorni
Curva di popolarità giornaliera
0,5 crediti per risultato
Pronto
README

A cura di SocQ · Aggiornato il

TikTok Creative Center Trending Hashtags

Gli hashtag di tendenza del Creative Center classificano i tag che ricevono più attenzione in un paese negli ultimi 7, 30 o 90 giorni, indicando per ciascuno posizione, numero di post, visualizzazioni e una curva di popolarità giorno per giorno. La classifica mostra quali argomenti stanno decollando in un mercato, quanto rapidamente è salito ogni tag e a quali tendenze conviene unirsi finché sono ancora in crescita.

Funzionalità della TikTok Creative Center Trending Hashtags API

  • Una classifica per paesecountry accetta un codice di due lettere come US, GB o JP e ogni mercato restituisce il proprio ordine di classifica.
  • Elenchi a 7, 30 e 90 giornitime_range sceglie l’intervallo su cui è costruita la classifica e ogni intervallo è un elenco a sé.
  • Numero di post e visualizzazionimetrics.posts_count e metrics.views_count indicano i volumi che il Creative Center riporta per ogni tag.
  • Curva di popolarità giornalierapopularity_curve restituisce un valore datato per ogni giorno su una scala da 0 a 100, così l’andamento di un tag arriva insieme alla sua riga di classifica.
  • Nome, link e ID del tagOgni riga contiene name senza #, un url tiktok.com/tag e l’id che Hashtag Insights accetta come hashtag_id.

Parametri della TikTok Creative Center Trending Hashtags API

ParametriObbligatorioDescrizione
countryFacoltativoCodice di due lettere del paese del mercato, per esempio US, GB o JP. Il valore predefinito è US.
time_rangeFacoltativoPeriodo coperto dalla classifica: 7d (predefinito), 30d o 90d.
results_limitFacoltativoQuanti hashtag restituire, da 1 a 100. Il valore predefinito è 20.

Come usare la TikTok Creative Center Trending Hashtags API

Scegli un paese e un intervallo, poi leggi la classifica.

  1. Invia con POST {"country": "US", "time_range": "7d", "results_limit": 20} a /v1/tiktok-creative-center/trending-hashtags.
  2. Interroga GET /v1/tasks/{task_id} finché status diventa succeeded.
  3. Leggi gli hashtag da results.items in ordine di classifica e ripassa results.next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtags" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"US","time_range":"7d","results_limit":20}'

# Each item has rank, metrics and a dated popularity_curve.

Casi d’uso della TikTok Creative Center Trending Hashtags API

  • Monitoraggio quotidiano dei nuovi ingressi: Salva l’elenco di ogni giorno con il suo collected_at e confronta gli id con l’istantanea precedente per vedere quali hashtag sono entrati nella classifica di un paese o ne sono usciti.
  • Selezioni di hashtag per mercato: Richiedi lo stesso time_range per ogni paese di interesse e metti gli elenchi uno accanto all’altro per scegliere i tag di ogni campagna localizzata.
  • Picco passeggero o tenuta nel tempo: Confronta gli elenchi 7d e 90d di un paese: i tag presenti solo nell’elenco breve sono picchi di una settimana, mentre quelli in alto in entrambi hanno mantenuto l’attenzione per mesi.

Consigli degli esperti per la TikTok Creative Center Trending Hashtags API

  • Salva ogni istantanea con country, time_range e collected_at, perché una posizione ha senso solo all’interno dell’elenco da cui proviene.
  • Riusa gli stessi country e time_range quando invii un id a Hashtag Insights.
  • Recupera una volta tutti i 100 risultati e filtrali in locale invece di ripetere richieste con valori di results_limit diversi, perché ogni richiesta viene fatturata in base alle righe restituite.

Oltre alla TikTok Creative Center Trending Hashtags API, usa queste API quando ti serve un altro tipo di dati pubblici di TikTok Creative Center.

Esplora altre piattaforme

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

TikTok Creative Center Trending Hashtags API — FAQ

TikTok Creative Center Trending Hashtags API è un’interfaccia programmatica per recuperare gli hashtag classificati come tendenze in un paese sul TikTok Creative Center negli ultimi 7, 30 o 90 giorni. Restituisce per ogni hashtag posizione, numero di post e visualizzazioni e una curva di popolarità giornaliera.

Invia country come codice di due lettere, per esempio US, GB o JP; il valore predefinito è US e ogni mercato ha la propria classifica. Un mercato senza una classifica pubblicata restituisce zero risultati e non viene addebitato.

Usa 7d per ciò che sta salendo in questo momento e 90d per i tag che mantengono l’attenzione da mesi. Ogni intervallo è un elenco separato, quindi lo stesso hashtag può avere posizioni diverse in ciascuno.

Fino a 100 per paese e intervallo, impostati con results_limit (predefinito 20). La fatturazione segue le righe restituite a 0,5 crediti ciascuna, quindi un elenco completo di 100 tag costa 50 crediti.

Leggi la parte finale della sua popularity_curve, i cui valori vanno da 0 a 100, uno per ogni giorno. Una serie che sale ancora nell’ultimo giorno è in crescita, mentre una che è scesa rispetto a un picco precedente si sta raffreddando, qualunque sia la posizione del tag.

No; la richiesta accetta solo country, time_range e results_limit. Per trovare i nuovi ingressi, salva l’elenco di ogni giorno e confronta gli id degli hashtag con quello precedente.

TikTok non pubblica un calendario di aggiornamento. La curva di popolarità si muove a passi giornalieri e ogni record riporta collected_at, quindi basta una richiesta per paese al giorno per seguirla.

No. Una chiave API di SocQ è l’unica credenziale necessaria.