YouTubeYouTube ShortsPost della communityOutreach ai creatorGuida alle API

Nuovi endpoint dell’API di YouTube: Shorts di tendenza, post della community, ricerca di canali ed email

Otto nuovi endpoint SocQ per YouTube restituiscono Shorts di tendenza, ricerca di Shorts e canali, suggerimenti di ricerca, post della community con i loro commenti, video correlati ed email aziendali dei canali.

SocQAggiornato il 19 novembre 20268 min di lettura

SocQ restituiva già canali, video, Shorts, commenti, ricerche, playlist e trascrizioni pubblici di YouTube. Le 7 migliori API per lo scraping di YouTube li mette a confronto e la guida alle trascrizioni di YouTube tratta il testo dei sottotitoli in blocco. Il 2026-11-17 sono stati pubblicati altri otto endpoint nella pagina della piattaforma YouTube. Colmano le lacune nella ricerca sugli Shorts, nella scoperta dei creator e nell’outreach, e coprono i post della community che i creator pubblicano tra un caricamento e l’altro.

Questa guida raggruppa i nuovi endpoint per attività, mostra una richiesta per ciascuno, ne indica il prezzo e spiega quando usarlo.

Risposta rapida: invia un corpo JSON a POST https://api.socq.ai/v1/youtube/<endpoint>. Salva il task_id restituito, interroga GET /v1/tasks/{task_id} finché status non è succeeded, poi leggi data.results.items.

I nuovi endpoint di YouTube in sintesi

1 credito SocQ = $0.005. Gli endpoint a pagamento per risultato non hanno un costo base, quindi un risultato vuoto non costa nulla.

EndpointCosa restituiscePrezzo
YouTube Trending Shorts APIUn campione aggiornato di Shorts di tendenza con canale, visualizzazioni, like, commenti, durata e data di pubblicazione0.5 crediti ($0.0025) per Short
YouTube Shorts Search APIShorts per una parola chiave con link, didascalia, visualizzazioni e miniatura verticale0.6 crediti ($0.003) per Short
YouTube Channel Search APICanali per una parola chiave con ID, nome, iscritti, avatar ed estratto della descrizione0.6 crediti ($0.003) per canale
YouTube Search Suggestions APISuggerimenti di completamento ordinati per una query parziale, per lingua e regione0.5 crediti ($0.0025) per chiamata
YouTube Community Post APIUn post della community: testo completo, tutte le immagini, like e canale0.5 crediti ($0.0025) per chiamata
YouTube Community Post Comments APICommenti sotto un post della community con autore, like e numero di risposte0.3 crediti ($0.0015) per commento
YouTube Related Videos APII video che YouTube consiglia accanto a un video0.5 crediti ($0.0025) per video
YouTube Email Finder APIEmail aziendali pubbliche di un canale e le pagine in cui sono state trovate15 crediti ($0.075) per canale con un’email; gratis se non ne viene trovata nessuna

Autenticazione e flusso asincrono delle attività

Tutte le richieste si autenticano con una chiave API. Lo stesso header vale per l’invio, lo stato dell’attività e le richieste dei risultati:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Ogni raccolta viene eseguita come attività in background:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

La chiamata di invio risponde subito con data.task_id e data.status. Interroga l’attività con quell’ID:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Quando status è succeeded, la risposta include result_count, credits_amount e la prima pagina di record normalizzati in data.results.items. limit vale 50 per impostazione predefinita e arriva fino a 500. Se results.has_more è true, passa results.next_cursor come cursor per leggere la pagina successiva. Un’attività non riuscita riporta error_message.

Tutti gli endpoint qui sotto accettano anche un callback_url facoltativo. Al termine dell’attività SocQ invia un’unica POST con un riepilogo; i record vanno letti dall’endpoint delle attività. Un timeout lato client non annulla l’attività, quindi riprendi con lo stesso ID invece di inviarla di nuovo. Un 402 indica che l’account ha esaurito i crediti, un 429 che la chiave ha raggiunto un limite di frequenza o di crediti.

Studiare gli Shorts e la domanda di ricerca

Trending Shorts campiona gli Shorts che YouTube sta proponendo come tendenza in questo momento, ognuno con titolo, canale, visualizzazioni, like, commenti, durata e data di pubblicazione. Tutti i campi sono facoltativi; results_limit vale 48 per impostazione predefinita e arriva fino a 200. Ogni esecuzione preleva un nuovo campione, quindi due esecuzioni a pochi minuti di distanza hanno in comune solo pochi Shorts. Un job pianificato offre così un quadro più ampio della giornata rispetto a una singola chiamata grande. (documentazione)

curl -X POST "https://api.socq.ai/v1/youtube/trending-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"results_limit": 48}'

Shorts Search restituisce gli Shorts per una parola chiave nell’ordine di ricerca di YouTube, con link, didascalia, numero di visualizzazioni e miniatura verticale. I risultati di ricerca contengono solo questi dati di base, quindi passa i link che vuoi tenere a YouTube Videos se ti servono anche like, commenti o dettagli del canale. results_limit vale 25 per impostazione predefinita (da 1 a 200). (documentazione)

curl -X POST "https://api.socq.ai/v1/youtube/search-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "meal prep", "results_limit": 25}'

Search Suggestions restituisce i completamenti che la casella di ricerca di YouTube propone per l’inizio di una query, ordinati come li vedono gli spettatori. language vale en per impostazione predefinita e region vale US; cambiali per vedere come lo stesso termine di partenza si ramifica in un altro mercato. Ogni chiamata viene addebitata una sola volta, qualunque sia il numero di suggerimenti. Usalo per la ricerca di parole chiave, titoli e tag. (documentazione)

curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "iphone 17"}'

Scoprire i creator e trovare la loro email di contatto

Channel Search trova i canali per una parola chiave, nell’ordine di YouTube, con ID del canale, nome, numero di iscritti, avatar e l’estratto della descrizione mostrato nei risultati. results_limit vale 20 per impostazione predefinita (da 1 a 200). È il primo passo della scoperta dei creator: crea qui una rosa di candidati, poi recupera i dettagli con YouTube Channels o i caricamenti con YouTube Channel Videos. (documentazione)

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}'

Email Finder cerca le email aziendali che un creator ha pubblicato: nella descrizione del canale, sui profili social collegati, sulle pagine link in bio o sul sito del creator. Ogni indirizzo in emails è accompagnato dai source_urls in cui è stato trovato. url accetta un link al canale nella forma @handle o /channel/UC.... Un canale con almeno un’email pubblica restituisce un risultato con tutti gli indirizzi trovati e costa 15 crediti ($0.075); un canale che non ne indica nessuna restituisce un risultato vuoto senza addebito. (documentazione)

curl -X POST "https://api.socq.ai/v1/youtube/channel-email" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/@mkbhd"}'

Esempio di costo: cerca 20 canali (12 crediti), poi esegui Email Finder su tutti e 20. Se 8 indicano un’email, sono 120 crediti, per un totale di 132 crediti ($0.66). Per i 12 canali senza email pubblica non paghi nulla.

Leggere i post della community e i loro commenti

Community Post legge un post a partire dal suo link: testo completo, tutte le immagini allegate, numero di like e canale che l’ha pubblicato. url accetta un link https://www.youtube.com/post/{post_id} o un link alla scheda Post di un canale che contiene ?lb={post_id}. Usalo quando hai già l’URL di un post, per esempio da un risultato di YouTube Community Posts. (documentazione)

curl -X POST "https://api.socq.ai/v1/youtube/community-post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8"}'

Community Post Comments raccoglie i commenti sotto un post, come un sondaggio, un annuncio o la pubblicazione di un’immagine, con il canale di ogni autore, metrics.likes_count e metrics.replies_count. I commenti ai post sono separati dai commenti ai video, quindi è così che leggi le reazioni agli aggiornamenti di un creator tra un caricamento e l’altro. Valgono le stesse forme di URL; results_limit vale 100 per impostazione predefinita (da 1 a 1000). (documentazione)

curl -X POST "https://api.socq.ai/v1/youtube/community-post-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ", "results_limit": 100}'

Vedere cosa consiglia YouTube dopo

Related Videos restituisce l’elenco che YouTube mette accanto a un video come cosa guardare dopo: titoli, canali, numero di visualizzazioni e miniature. url accetta un link di visualizzazione, youtu.be, Shorts o live. Un’esecuzione restituisce l’intero elenco di consigli, di solito circa 20 video, addebitati per video, quindi una chiamata tipica costa circa 10 crediti ($0.05). Eseguilo sui tuoi caricamenti o su quelli di un concorrente per vedere quali video e canali YouTube considera loro vicini. (documentazione)

curl -X POST "https://api.socq.ai/v1/youtube/related-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

Guide correlate su YouTube

Per confrontare SocQ con altri fornitori di dati di YouTube, leggi Le 19 migliori alternative all’API di YouTube. Lo stesso flusso di scoperta e outreach per TikTok, con i paesi dei follower e il controllo delle visualizzazioni false, è nella guida ai nuovi endpoint di TikTok.

Domande frequenti (FAQ)

Pago per i canali senza email pubblica?

No. Un canale senza email pubblica restituisce un risultato vuoto, che è gratuito. Un canale con almeno un’email costa 15 crediti, qualunque sia il numero di indirizzi indicati.

Ogni esecuzione campiona ciò che è di tendenza in quel momento, quindi esecuzioni a pochi minuti di distanza hanno in comune solo pochi Shorts. Pianifica più esecuzioni se vuoi una copertura più ampia.

Quali URL dei post della community sono accettati?

https://www.youtube.com/post/{post_id}, oppure un link alla scheda Post di un canale che contiene ?lb={post_id}.

Shorts Search restituisce like e commenti?

No. I risultati di ricerca contengono link, didascalia, numero di visualizzazioni e miniatura. Passa i link a YouTube Videos per ottenere like, commenti e dettagli del canale.

Come viene addebitato Search Suggestions?

0.5 crediti per chiamata, qualunque sia il numero di suggerimenti restituiti.

YOUTUBE API

Prova il flusso di lavoro con un URL pubblico di YouTube

Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.

Scopri le API di YouTube