tiktok-creative-center/
trending-hashtag-detail

Consulta un singolo hashtag di tendenza di TikTok tramite l’ID del Creative Center: numero di post e visualizzazioni, curva di popolarità giornaliera, paesi principali per punteggio e ID di video di esempio.

TikTok Creative Center Hashtag Insights API

Input con ID hashtag
Paesi principali
Video di esempio
0,5 crediti per richiesta
Pronto
README

A cura di SocQ · Aggiornato il

TikTok Creative Center Hashtag Insights

Un approfondimento sugli hashtag del Creative Center descrive un singolo tag di tendenza in un mercato: numero di post e visualizzazioni, una curva di popolarità giornaliera, i paesi in cui è più popolare in rapporto alle loro dimensioni e alcuni video di esempio che lo usano. Insieme questi dati mostrano come si muove una tendenza, dove altro trova riscontro e quale tipo di contenuti la sostiene.

Funzionalità della TikTok Creative Center Hashtag Insights API

  • Un tag, cercato per IDhashtag_id accetta l’id di un risultato di Trending Hashtags e restituisce un solo record per quel tag nel paese e nel time_range scelti.
  • Curva e conteggi dell’intervallopopularity_curve fornisce un valore datato per ogni giorno da 0 a 100, accanto a metrics.posts_count e metrics.views_count.
  • Paesi in ordine di punteggiotop_countries elenca country_code e score a partire dal più alto, dove il punteggio riflette la popolarità in rapporto alle dimensioni del paese.
  • ID di video di esempiovideo_ids elenca video che usano il tag e mostra su quali contenuti si basa la tendenza.

Parametri della TikTok Creative Center Hashtag Insights API

ParametriObbligatorioDescrizione
hashtag_idObbligatorioID dell’hashtag preso da un risultato di TikTok Creative Center Trending Hashtags.
countryFacoltativoCodice di due lettere del paese del mercato, per esempio US, GB o JP. Il valore predefinito è US.
time_rangeFacoltativoPeriodo da analizzare: 7d (predefinito), 30d o 90d.

Come usare la TikTok Creative Center Hashtag Insights API

Prendi l’ID di un hashtag dalla classifica delle tendenze e leggi il suo approfondimento.

  1. Raccogli gli hashtag con TikTok Creative Center Trending Hashtags e copia un id.
  2. Invia con POST {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"} a /v1/tiktok-creative-center/trending-hashtag-detail.
  3. Interroga GET /v1/tasks/{task_id} finché status diventa succeeded e leggi l’unico record in results.items.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtag_id":"7155204034885287979","country":"US","time_range":"7d"}'

# top_countries lists {country_code, score}; video_ids lists example videos.

Casi d’uso della TikTok Creative Center Hashtag Insights API

  • Decidere se puntare su una tendenza: Leggi popularity_curve e i conteggi in metrics prima di legare una campagna a un tag e verifica se la curva sta ancora salendo nell’ultimo giorno.
  • Valutare nuovi mercati per l’espansione: Usa top_countries per vedere quali altri paesi ottengono il punteggio più alto per un tag di tendenza nel tuo mercato e selezionali per post localizzati.

Consigli degli esperti per la TikTok Creative Center Hashtag Insights API

  • Passa gli stessi country e time_range della classifica da cui proviene l’id, così i dati descrivono l’elenco in cui hai scelto il tag.
  • Non leggere top_countries come una classifica per volume: il punteggio è relativo alle dimensioni del paese, quindi un mercato piccolo può stare sopra uno grande.

Oltre alla TikTok Creative Center Hashtag Insights 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 Hashtag Insights API — FAQ

TikTok Creative Center Hashtag Insights API è un’interfaccia programmatica per recuperare il record di approfondimento di un singolo hashtag di tendenza di TikTok, identificato da ID del Creative Center, paese e intervallo di tempo. Restituisce numero di post e visualizzazioni, una curva di popolarità giornaliera, i paesi principali per punteggio e ID di video di esempio.

Nel campo id di un risultato di Trending Hashtags, preso dalla classifica del paese che interrogherai. È una stringa numerica da 5 a 32 cifre e qualsiasi altro formato viene rifiutato con un errore 400.

Non qui, perché questo endpoint accetta solo l’ID numerico. Per ottenere il numero di video e le visualizzazioni totali di un tag a partire dal nome, usa TikTok Hashtag Views API.

top_countries e video_ids, che nelle righe della classifica sono null. Qui rank è null perché la posizione appartiene alla classifica, quindi conserva il rank dal risultato di Trending Hashtags.

Misura quanto è popolare l’hashtag in quel paese in rapporto alle dimensioni del paese, e l’elenco è ordinato dal punteggio più alto. Un mercato piccolo può quindi superare uno grande.

L’attività fallisce con un rimborso completo. Una richiesta riuscita viene fatturata una sola volta a 0,5 crediti, indipendentemente da quanti video_ids vengono restituiti.