youtube/
search-channels

Cerca canali YouTube per parola chiave e ottieni ID dei canali, nomi, numero di iscritti, avatar e l’estratto della descrizione mostrato da YouTube, nell’ordine dei risultati di ricerca.

YouTube Channel Search API

Input con parola chiave
Numero di iscritti
Fino a 200 canali
0,6 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 Channel Search

I risultati della ricerca di canali sono gli account dei creator che YouTube associa a una parola chiave, ciascuno con nome, avatar, numero di iscritti e le prime righe della descrizione. Scorrerli è il modo più rapido per capire chi tratta un argomento, distinguere i canali grandi da quelli emergenti e mettere insieme un primo elenco per la ricerca sui creator o l’outreach.

Funzionalità della YouTube Channel Search API

  • Solo canaliLa ricerca è limitata ai canali, quindi una parola chiave come home cooking restituisce esclusivamente account di creator anziché un misto di video e playlist.
  • Numero di iscritti per canalemetrics.followers_count contiene il totale degli iscritti ricavato dal valore mostrato da YouTube, per esempio 3.69M.
  • ID e link dei canali stabiliOgni risultato riporta l’ID del canale UC e un URL del canale costruito a partire da esso, pronto per le API a livello di canale.
  • Estratto della descrizionetext contiene l’estratto della descrizione mostrato nella ricerca, che spesso indica la nicchia o include un contatto business.

Parametri della YouTube Channel Search API

ParametriObbligatorioDescrizione
queryObbligatorioLa parola chiave per cui trovare canali, fino a 100 caratteri.
results_limitFacoltativoQuanti canali restituire, da 1 a 200. Il valore predefinito è 20.

Come usare la YouTube Channel Search API

Cerca con una parola chiave e scorri i canali corrispondenti.

  1. Invia con POST {"query": "home cooking", "results_limit": 20} a /v1/youtube/search-channels.
  2. Interroga GET /v1/tasks/{task_id} finché status diventa succeeded.
  3. Leggi i canali da results.items e ripassa results.next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/youtube/search-channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"home cooking","results_limit":20}'

# Each item is one channel with name, text and metrics.followers_count.

Casi d’uso della YouTube Channel Search API

  • Creare una rosa di creator: Cerca le parole chiave della tua nicchia e tieni i canali il cui followers_count rientra nella fascia di dimensioni con cui lavori.
  • Capire chi domina un argomento: Confronta il numero di iscritti dei primi risultati per una parola chiave per valutare se pochi grandi canali la dominano.
  • Avviare la ricerca sui canali: Passa gli URL dei canali restituiti a YouTube Channels e YouTube Channel Videos per tracciare un profilo approfondito di ogni creator.

Consigli degli esperti per la YouTube Channel Search API

  • Il numero di iscritti deriva da testo arrotondato, quindi usa YouTube Channels quando ti serve il valore esatto all’unità.
  • Prova più formulazioni di un argomento e unisci i risultati per id del canale per ampliare l’elenco.
  • Passa i canali promettenti a YouTube Email Finder per vedere se pubblicano un contatto business.

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

  • YouTube Channel Videos API — Raccoglie i video pubblici regolari dagli URL dei canali, esclusi Shorts e dirette.
  • YouTube Channels API — Recupera identità del canale pubblico, immagini, verifica e statistiche visibili del pubblico.
  • YouTube Search API — Cerca video pubblici regolari per parola chiave con filtri sui metadati supportati.
  • YouTube Hashtag Search API — Trova video pubblici dai feed degli hashtag, raccogliendo tutti i contenuti oppure solo gli Shorts.
  • YouTube Shorts Search API — Cerca Shorts per parola chiave, con link, didascalie, numero di visualizzazioni e miniature verticali.
  • YouTube Email Finder API — Trova le email business pubbliche a partire dall’URL di un canale, con le pagine in cui compare ogni indirizzo.

Esplora altre piattaforme

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

YouTube Channel Search API — FAQ

YouTube Channel Search API è un’interfaccia programmatica per trovare i canali YouTube che corrispondono a una parola chiave. Restituisce ID dei canali, nomi, numero di iscritti, avatar ed estratti della descrizione nell’ordine di ricerca di YouTube.

Imposta results_limit da 1 a 200; il valore predefinito è 20. I risultati vengono paginati automaticamente fino al limite o alla fine dei risultati di YouTube.

I risultati di ricerca identificano i canali tramite l’ID del canale UC e l’URL del canale. Invia quell’URL a YouTube Channels per ottenere l’handle e il profilo completo.

No. Le richieste usano la tua chiave API di SocQ e vengono fatturate in crediti per canale restituito, quindi non c’è alcun progetto Google Cloud né quota giornaliera da gestire.

Ogni canale restituito costa 0,6 crediti, quindi i 20 canali predefiniti costano 12 crediti.