youtube/
hashtag-search

Trova video pubblici di YouTube tramite uno o più hashtag, con titoli, identità del canale, miniature, durata, engagement e contesto dell’hashtag di origine come record normalizzati.

YouTube Hashtag Search API

Feed degli hashtag
Filtro Shorts
Hashtag di origine
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

YouTube Hashtag Search

I feed degli hashtag di YouTube sono raccolte pubbliche di video associate a un tag tematico, con titoli, descrizioni, identità del canale, miniature, durata, dettagli di pubblicazione ed engagement visibile. Questi record supportano la mappatura degli argomenti, la revisione della partecipazione alle campagne, il campionamento degli Shorts e l’analisi comparativa dei contenuti.

Funzionalità della YouTube Hashtag Search API

  • Scoperta dai feed degli hashtagTrova i video pubblici associati a un hashtag senza dover fornire URL di video o di canali.
  • Modalità tutti i contenuti e ShortsImposta content_type su all per il feed dell’hashtag così come esposto o su shorts per un campione di soli Shorts.
  • Contesto di video e canaleRestituisce titoli, descrizioni, identità del canale, miniature, durata, dettagli di pubblicazione e numero visibile di visualizzazioni, Mi piace e commenti.
  • Hashtag di origine conservatoOgni record salvato include l’hashtag di origine normalizzato conservato per quel risultato video.

Parametri della YouTube Hashtag Search API

ParametriObbligatorioDescrizione
hashtagsObbligatorioUno o più hashtag non vuoti. Il # iniziale è facoltativo e viene rimosso prima della raccolta.
results_limitFacoltativoNumero massimo di video da raccogliere per ogni hashtag, da 20 a 2.000; il valore predefinito è 100.
content_typeFacoltativoModalità dei contenuti: all per il feed dell’hashtag così come esposto o shorts per i risultati di soli Shorts; il valore predefinito è all.

Come usare la YouTube Hashtag Search API

Scegli i tag che rappresentano i confini dell’argomento da esaminare, poi mantieni coerenti la modalità dei contenuti e il limite per tag quando i campioni devono essere confrontati.

  1. Prepara uno o più hashtag non vuoti, con o senza # iniziale, e seleziona all o shorts.
  2. Invia con POST hashtags, results_limit e content_type a /v1/youtube/hashtag-search.
  3. Salva il task_id restituito e interroga /v1/tasks/{task_id} finché l’attività ha successo o fallisce.
  4. Leggi i video normalizzati da data.results.items e continua con next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/youtube/hashtag-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["#technology"],"results_limit":20,"content_type":"shorts"}'

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

Casi d’uso della YouTube Hashtag Search API

  • Revisione della partecipazione alle campagne: Usa campioni dei feed degli hashtag, descrizioni dei video, identità dei canali ed engagement visibile per rivedere la partecipazione pubblica alle campagne.
  • Campionamento di Shorts per argomento: Seleziona shorts per costruire un campione mirato di video in formato breve associati a un tag tematico.
  • Preparazione di dataset tematici: Combina ID dei video, URL, dettagli di pubblicazione, contesto del canale, metriche e tag di origine conservati in dataset di ricerca strutturati.

Consigli degli esperti per la YouTube Hashtag Search API

  • Normalizza l’elenco di input prima dell’invio, così #technology e technology non generano lavoro di raccolta duplicato.
  • Usa un hashtag per attività quando conta l’attribuzione tra feed sovrapposti, perché gli ID video duplicati vengono salvati una sola volta e conservano un solo hashtag di origine.
  • Considera results_limit come un tetto per hashtag; la raccolta può fermarsi prima quando il feed termina o espone meno video idonei.
  • Tieni separati i campioni all e shorts quando confronti i formati, così un feed misto non distorce il sottoinsieme in formato breve.
  • Salva gli URL delle miniature e delle origini come riferimenti, senza dare per scontato che siano download multimediali permanenti.

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

  • YouTube Comments API — Raccoglie commenti pubblici, autori, engagement, video di origine e contesto della conversazione.
  • YouTube Videos API — Recupera metadati, miniature, durata ed engagement a partire dagli URL di video o Short noti.
  • YouTube Shorts API — Raccoglie Shorts pubblici, miniature, durata, dettagli di pubblicazione ed engagement per canale.
  • YouTube Search API — Cerca video pubblici regolari per parola chiave con filtri sui metadati supportati.
  • YouTube Channel Search API — Trova canali per parola chiave, con nomi, numero di iscritti, avatar ed estratti della descrizione.
  • YouTube Shorts Search API — Cerca Shorts per parola chiave, con link, didascalie, numero di visualizzazioni e miniature verticali.

Esplora altre piattaforme

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

YouTube Hashtag Search API — FAQ

YouTube Hashtag Search API è un’interfaccia programmatica per trovare video pubblici associati a uno o più hashtag. Restituisce campi normalizzati di video e canale, miniature, durata, dettagli di pubblicazione, engagement visibile e un hashtag di origine conservato.

Invia un array non vuoto di stringhe come technology o #technology. Il # iniziale è facoltativo e viene rimosso prima della raccolta.

Sì. Imposta content_type su shorts per ottenere solo gli Shorts, oppure lascia la modalità predefinita all per il feed dell’hashtag così come esposto.

results_limit si applica separatamente a ogni hashtag inviato, ha 100 come valore predefinito e accetta interi da 20 a 2.000. Il feed esposto o il tetto di raccolta di 100 pagine possono produrre meno record.

Gli ID o gli URL dei video ripetuti vengono salvati una sola volta all’interno di un’attività. Se conta l’attribuzione esatta al feed, invia gli hashtag in attività separate, perché un record salvato conserva un solo hashtag di origine.

Ogni video normalizzato salvato costa 0,5 crediti, senza costo base. La stima della richiesta moltiplica results_limit, o il suo valore predefinito di 100, per il numero di hashtag; l’utilizzo finale segue il numero effettivo di record salvati e un insieme di risultati vuoto non ha alcun addebito per i risultati.