tiktok/
hashtags

Raccogli i video pubblici di TikTok per uno o più hashtag, con contesto normalizzato di creator, didascalia, media, audio, engagement e hashtag corrispondente.

TikTok Hashtags API

Monitoraggio delle campagne
Contenuti della community
Confronto tra tag
0,7 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 Hashtags

Gli hashtag di TikTok sono etichette tematiche che collegano video pubblici attorno a una frase, una campagna, un evento o un interesse condiviso, con segnali su creator, contenuto, media, audio ed engagement. Questi record supportano la scoperta delle tendenze, il monitoraggio degli argomenti, la ricerca sulle campagne e l’analisi del pubblico.

Funzionalità della TikTok Hashtags API

  • Raccolta di hashtag in paralleloInvia in parallelo più hashtag di campagna, di brand o di community.
  • Input di hashtag normalizzatiNormalizza #campaign e campaign in un formato di tag coerente.
  • Limiti di risultati per tagApplica results_limit per ogni tag per pianificare chiaramente il campione.
  • Contesto dell’hashtag corrispondenteConserva il gruppo inviato tramite matched_hashtag su ogni video.
  • Record di video confrontabiliConfronta visualizzazioni degli hashtag, creator, elementi creativi ed engagement dei video in un’unica struttura di dati.

Parametri della TikTok Hashtags API

ParametriObbligatorioDescrizione
hashtagsObbligatorioElenco obbligatorio di valori espliciti di hashtag con # iniziale facoltativo.
results_limitFacoltativoLimite positivo richiesto di video per ogni hashtag. Il valore predefinito è 100.

Come usare la TikTok Hashtags API

Elenca i tag da monitorare, imposta la dimensione del campione di video per ciascuno e costruisci un dataset pronto per il confronto tra gruppi.

  1. Raccogli i tag di campagna, di brand o di community, normalizza space e #space, poi deduplicali.
  2. Invia con POST hashtags e results_limit a /v1/tiktok/hashtags e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività va a buon fine o fallisce.
  4. Leggi data.results.items. Quando has_more è true, continua con next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/hashtags" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["space","#astronomy"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso della TikTok Hashtags API

  • Monitoraggio delle campagne UGC: Raccogli la partecipazione sotto i tag ufficiali di una campagna ed esamina copertura dei creator, direzione dei contenuti e distribuzione dell’engagement.
  • Inventari di asset dei tag di brand: Trasforma i video degli hashtag di brand e prodotto in una libreria consultabile per i team di marketing e social.
  • Profili delle community di interesse: Usa creator, didascalie, musica ed engagement per capire la cultura dei contenuti attorno a un tag di interesse.
  • Confronto tra gruppi di hashtag: Raccogli più tag in parallelo e confronta mix di creator, elementi creativi e prestazioni tra i gruppi.

Consigli degli esperti per la TikTok Hashtags API

  • Rimuovi il # iniziale, normalizza le maiuscole e deduplica i valori, così ogni tag ha un gruppo di campionamento chiaro.
  • Usa il numero di tag moltiplicato per results_limit come massimo richiesto, non come totale garantito dei risultati.
  • Conserva matched_hashtag, così i video raccolti tramite più gruppi mantengono una provenienza completa.
  • Usa lo stesso results_limit e la stessa tempistica di raccolta quando confronti gruppi di hashtag.
  • Tratta il numero di visualizzazioni dell’hashtag e le metriche di engagement di ogni video come valori distinti riferiti a un dato momento.
  • Arricchisci i creator più frequenti con i dati di Profiles per capire il mix di creator che ogni tag attira.

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

  • TikTok Comments API — Raccoglie i commenti pubblici di primo livello, autori, engagement, menzioni e flag di interazione del creator.
  • TikTok Videos API — Recupera creator, didascalia, media, musica, tag, menzioni ed engagement dagli URL dei video.
  • TikTok Search API — Cerca video pubblici per parola chiave con ordinamento e filtri di pubblicazione supportati.
  • TikTok Live Room Info API — Consulta una diretta nota tramite la coppia di ID della stanza e del proprietario, restituendo stato, contesto del proprietario, immagine di copertina e conteggi del pubblico.
  • TikTok Search Users API — Cerca account TikTok pubblici per parola chiave.
  • TikTok Hashtag Views API — Consulta il numero totale di video e di visualizzazioni di un massimo di 20 hashtag alla volta.

Esplora altre piattaforme

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

TikTok Hashtags API — FAQ

TikTok Hashtags API raccoglie i video accessibili pubblicamente per uno o più hashtag TikTok specificati. Restituisce dati normalizzati di video, creator, didascalia, media, audio, engagement e hashtag corrispondente.

Inserisci i nomi dei tag nell’array hashtags. Sono accettati sia il formato fyp sia #fyp e il # iniziale viene normalizzato prima della raccolta.

Sì. hashtags accetta più nomi di tag, che vengono raccolti separatamente nella stessa attività asincrona.

results_limit si applica separatamente a ogni tag inserito e ha come valore predefinito 100. Tre tag con un valore di 100 richiedono fino a 100 video per ciascun tag.

matched_hashtag registra il tag di input che ha prodotto il video e può essere abbinato al numero pubblico di visualizzazioni dell’hashtag per l’attribuzione e l’analisi per gruppi.

I risultati includono ID del video, URL, didascalia, orario di pubblicazione, creator, engagement pubblico, hashtag, menzioni, media, musica e momento di raccolta.

Raggruppa i risultati per matched_hashtag, poi confronta tra i gruppi mix di creator, didascalie, musica, visualizzazioni degli hashtag ed engagement dei video.

Ogni risultato normalizzato di un video per hashtag restituito costa 0,7 crediti.