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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
hashtags | Obbligatorio | Uno o più hashtag non vuoti. Il # iniziale è facoltativo e viene rimosso prima della raccolta. |
results_limit | Facoltativo | Numero massimo di video da raccogliere per ogni hashtag, da 20 a 2.000; il valore predefinito è 100. |
content_type | Facoltativo | Modalità 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.
- Prepara uno o più hashtag non vuoti, con o senza # iniziale, e seleziona all o shorts.
- Invia con POST hashtags, results_limit e content_type a /v1/youtube/hashtag-search.
- Salva il task_id restituito e interroga /v1/tasks/{task_id} finché l’attività ha successo o fallisce.
- 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 trueCasi 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.
API correlate
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.
- YouTube Channel Videos API
- YouTube Transcripts API
- YouTube Channels API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API