youtube/
search

Cerca video pubblici di YouTube per parola chiave con filtri per ordinamento, data, durata e sottotitoli, e ottieni metadati normalizzati, contesto del canale, miniature ed engagement.

YouTube Search API

Ricerca di video
Scoperta
Filtri portabili
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 Search

I risultati di YouTube Search sono video pubblici regolari corrispondenti a una parola chiave o a una frase, con titoli, canali, miniature, durata, dettagli di pubblicazione ed engagement visibile. Questi record supportano la scoperta di argomenti, la ricerca sui contenuti, il monitoraggio dei concorrenti e l’analisi delle opportunità.

Funzionalità della YouTube Search API

  • Scoperta di video senza URLScopri i video pubblici regolari senza conoscerne in anticipo gli URL.
  • Ordinamento dei risultatiOrdina i risultati per rilevanza, data di pubblicazione, valutazione o numero pubblico di visualizzazioni.
  • Finestre di pubblicazioneFiltra i risultati per finestre di pubblicazione di un’ora, un giorno, una settimana, un mese o un anno.
  • Filtri per durata e sottotitoliFiltra per durata breve, media o lunga e richiedi la disponibilità dei sottotitoli quando serve.
  • Risultati video normalizzatiRestituisce metadati normalizzati dei video, informazioni sul canale, miniature, durata, dati di pubblicazione e metriche pubbliche.

Parametri della YouTube Search API

ParametriObbligatorioDescrizione
queryObbligatorioParola chiave o frase usata per scoprire video pubblici.
results_limitFacoltativoNumero massimo di risultati di video pubblici da richiedere. Deve essere un intero positivo e ha 100 come valore predefinito.
sort_byFacoltativoOrdinamento dei risultati. Il valore predefinito è relevance.
published_withinFacoltativoFinestra di pubblicazione facoltativa, misurata dal momento della richiesta.
durationFacoltativoCategoria di durata di YouTube facoltativa.
has_captionsFacoltativoFiltro facoltativo sulla disponibilità dei sottotitoli. Lascialo intatto per omettere questo filtro.

Come usare la YouTube Search API

Scrivi la query come una strategia di recupero, non come una semplice parola chiave. Parti abbastanza in largo da esaminare il panorama, poi aggiungi un filtro alla volta per capire quale scelta ha eliminato i candidati.

  1. Definisci l’argomento e la domanda: migliori corrispondenze tematiche, copertura più recente, contenuti molto visti o candidati pronti per la trascrizione.
  2. Invia con POST query e results_limit, più solo l’ordinamento e i filtri necessari per quella domanda, a /v1/youtube/search.
  3. Salva la richiesta completa insieme al task_id, poi interroga /v1/tasks/{task_id} finché la scoperta ha successo o fallisce.
  4. Deduplica i risultati per ID del video, conserva il contesto della posizione e collected_at, e scorri le pagine finché has_more è true.
curl -X POST "https://api.socq.ai/v1/youtube/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"NASA Artemis","results_limit":10,"sort_by":"date","published_within":"month","duration":"medium","has_captions":true}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Casi d’uso della YouTube Search API

  • Ricerca su argomenti e mercati: Scopri video pubblici su prodotti, settori, organizzazioni, eventi o argomenti emergenti.
  • Scoperta di creator e concorrenti: Usa i risultati di ricerca e le informazioni sul canale che pubblica per individuare creator, brand o concorrenti rilevanti.
  • Monitoraggio dei video recenti: Combina l’ordinamento per data e le finestre di pubblicazione per raccogliere i video recenti da rivedere o analizzare.
  • Dataset pronti per la trascrizione: Richiedi la disponibilità dei sottotitoli per trovare video da usare nella raccolta di trascrizioni, nel riassunto, nella classificazione o nella ricerca.

Consigli degli esperti per la YouTube Search API

  • Prova due o tre varianti precise della query invece di nascondere ogni concetto in un’unica frase lunga. La sovrapposizione è spesso istruttiva quanto le differenze.
  • Aggiungi i filtri in modo progressivo. Se specifichi finestra di pubblicazione, durata e sottotitoli tutti insieme, un risultato vuoto dà pochi indizi su quale vincolo fosse troppo stretto.
  • Usa date con published_within per il monitoraggio; relevance senza finestra risponde a una domanda di ricerca diversa e più ampia.
  • La classifica non è stabile. Salva la richiesta, l’ID attività, l’ID del video e collected_at ogni volta che contano la posizione o la composizione del campione.
  • results_limit è un tetto, non una garanzia di completezza. L’idoneità pubblica e i filtri scelti possono produrre meno record.
  • Deduplica tra le varianti della query per ID del video, ma conserva quale query ha prodotto ogni corrispondenza per l’analisi successiva della rilevanza.
  • Quando l’URL è già noto, usa Videos per i dettagli aggiornati e Transcripts per il testo dei sottotitoli disponibili, invece di cercarlo ripetutamente.

Oltre alla YouTube 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 Transcripts API — Recupera le trascrizioni disponibili in testo semplice con scelta facoltativa della lingua.
  • YouTube Channels API — Recupera identità del canale pubblico, immagini, verifica e statistiche visibili del pubblico.
  • YouTube Videos API — Recupera metadati, miniature, durata ed engagement a partire dagli URL di video o Short noti.
  • YouTube Hashtag Search API — Trova video pubblici dai feed degli hashtag, raccogliendo tutti i contenuti oppure solo gli Shorts.
  • YouTube Channel Search API — Trova canali per parola chiave, con nomi, numero di iscritti, avatar ed estratti della descrizione.

Esplora altre piattaforme

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

YouTube Search API — FAQ

YouTube Search API trova video pubblici regolari a partire da una parola chiave o da una frase, con ordinamenti e filtri supportati. Restituisce metadati normalizzati, informazioni sul canale, miniature, durata, date di pubblicazione, metriche di engagement e momento della raccolta.

Invia una parola chiave o una frase non vuota, come un argomento, una persona, un prodotto, un’organizzazione, un brand, una campagna o un evento.

sort_by accetta relevance, date, rating o view_count. relevance è il valore predefinito.

Puoi filtrare per published_within, duration e has_captions. Le finestre di pubblicazione sono hour, day, week, month o year; i valori di durata sono short, medium o long.

No. I risultati sono un campione pubblico limitato e possono cambiare con posizionamento, freschezza, area geografica, lingua, disponibilità e filtri scelti.

No. has_captions filtra in base alla disponibilità dei sottotitoli. Usa Transcripts per recuperare i sottotitoli disponibili in testo semplice per gli URL di video selezionati.

L’utilizzo costa 0,5 crediti per ogni risultato di ricerca normalizzato restituito.