tiktok/
hashtag-detail

Scopri quanti video e quante visualizzazioni totali hanno fino a 20 hashtag di TikTok in una sola richiesta, con l’ID e il link alla pagina di ogni hashtag per confrontarli fianco a fianco.

TikTok Hashtag Views API

Fino a 20 hashtag
Visualizzazioni totali
Numero di video
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 Hashtag Views

La pagina di un hashtag di TikTok riassume tutti i video pubblici che usano il tag in due totali cumulativi: quanti video lo riportano e quante visualizzazioni hanno raccolto quei video. Letti insieme mostrano quanto è grande e quanto è affollato un argomento, mentre le visualizzazioni per video suggeriscono quanto rendono di solito i contenuti con quel tag.

Funzionalità della TikTok Hashtag Views API

  • Fino a 20 hashtag per richiestaInvia da 1 a 20 nomi, con o senza #, e ottieni un record per ogni hashtag esistente.
  • Totali come numeri interimetrics.posts_count e metrics.views_count vengono restituiti come semplici interi e non come stringhe abbreviate, quindi puoi ordinarli e dividerli direttamente.
  • ID dell’hashtag e link alla pagina del tagid contiene l’ID numerico dell’hashtag su TikTok e url la pagina del tag, così ogni record ha una chiave da usare per unire le diverse esecuzioni.

Parametri della TikTok Hashtag Views API

ParametriObbligatorioDescrizione
hashtagsObbligatorioDa uno a 20 nomi di hashtag, con o senza il prefisso #.

Come usare la TikTok Hashtag Views API

Invia un elenco di hashtag e leggi un record per ogni tag.

  1. Invia con POST {"hashtags": ["cooking", "booktok"]} a /v1/tiktok/hashtag-detail.
  2. Interroga GET /v1/tasks/{task_id} finché status è succeeded.
  3. Leggi name, metrics.posts_count e metrics.views_count di ogni hashtag da results.items.
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["cooking","booktok"]}'

# metrics.posts_count is the video count; metrics.views_count is the total views.

Casi d’uso della TikTok Hashtag Views API

  • Selezione degli hashtag di una campagna: Inserisci i tag candidati in una sola richiesta e confronta posts_count per l’affollamento e views_count per la copertura prima di scegliere un set.
  • Monitoraggio dell’hashtag del brand: Recupera a intervalli regolari il tag della tua campagna e traccia come crescono il numero di video e le visualizzazioni totali dopo ogni spinta.
  • Ricerca sulla dimensione degli argomenti: Cerca i tag che definiscono una nicchia, una tendenza o un tema pubblico e confronta i loro totali per vedere dove si concentrano i contenuti su quell’argomento.

Consigli degli esperti per la TikTok Hashtag Views API

  • Non sommare views_count di più hashtag per misurare un argomento, perché un video che ne usa diversi viene contato sotto ciascuno; confronta i tag fianco a fianco oppure usa il più grande.
  • Dividi views_count per posts_count solo quando posts_count è presente e maggiore di zero, poi ordina i tag per visualizzazioni medie per video per confrontare dimensioni molto diverse.
  • Quando segui un tag, salva ogni risultato con il suo orario collected_at; ogni richiesta restituisce i totali attuali, quindi la crescita emerge solo se conservi le istantanee precedenti.
  • Abbina i risultati al tuo elenco di input per name o id, non per posizione, perché un hashtag inesistente viene saltato e l’output può essere più corto dell’input.

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

  • TikTok Hashtags API — Raccoglie video pubblici, creator, media, suoni ed engagement per gli hashtag indicati.
  • 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 Top Search API — Cerca per parola chiave video e post con immagini, con didascalie, creator e conteggi delle interazioni.
  • TikTok Trending Searches API — Ottiene le ricerche di tendenza di oggi su TikTok in ordine di classifica.

Esplora altre piattaforme

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

TikTok Hashtag Views API — FAQ

TikTok Hashtag Views API è un’interfaccia programmatica per consultare per nome i totali di un massimo di 20 hashtag di TikTok. Restituisce per ogni hashtag l’ID, l’URL della pagina, il numero di video e le visualizzazioni totali.

Invia il nome dell’hashtag e leggi metrics.views_count per le visualizzazioni totali e metrics.posts_count per il numero di video che usano il tag. Entrambi sono valori cumulativi dell’hashtag nel suo complesso.

La risposta riporta metrics.views_count accanto a metrics.posts_count per ogni hashtag, e un contatore che TikTok non fornisce per un tag viene restituito come null.

Fino a 20, scritti con o senza #. Ogni hashtag esistente restituisce un proprio record, quindi un’intera rosa di candidati si confronta da un solo risultato.

Viene escluso dai risultati e non viene addebitato, mentre gli altri hashtag della richiesta vengono comunque restituiti. Una richiesta in cui nessuno degli hashtag esiste non costa nulla.

L’endpoint restituisce i totali attuali con un orario collected_at e nessuna cronologia. Eseguilo a intervalli regolari e conserva ogni istantanea per tracciare la crescita.

No, solo i totali e gli identificatori dell’hashtag. Usa TikTok Hashtags per raccogliere i video veri e propri.

Per ogni hashtag esistente, a 0,5 crediti ciascuno. Un elenco di 20 tag esistenti costa quindi 10 crediti e una richiesta senza corrispondenze non costa nulla.