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 iltask_idrestituito, interrogaGET /v1/tasks/{task_id}finchéstatusnon èsucceeded, poi leggidata.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.
| Endpoint | Cosa restituisce | Prezzo |
|---|---|---|
| YouTube Trending Shorts API | Un campione aggiornato di Shorts di tendenza con canale, visualizzazioni, like, commenti, durata e data di pubblicazione | 0.5 crediti ($0.0025) per Short |
| YouTube Shorts Search API | Shorts per una parola chiave con link, didascalia, visualizzazioni e miniatura verticale | 0.6 crediti ($0.003) per Short |
| YouTube Channel Search API | Canali per una parola chiave con ID, nome, iscritti, avatar ed estratto della descrizione | 0.6 crediti ($0.003) per canale |
| YouTube Search Suggestions API | Suggerimenti di completamento ordinati per una query parziale, per lingua e regione | 0.5 crediti ($0.0025) per chiamata |
| YouTube Community Post API | Un post della community: testo completo, tutte le immagini, like e canale | 0.5 crediti ($0.0025) per chiamata |
| YouTube Community Post Comments API | Commenti sotto un post della community con autore, like e numero di risposte | 0.3 crediti ($0.0015) per commento |
| YouTube Related Videos API | I video che YouTube consiglia accanto a un video | 0.5 crediti ($0.0025) per video |
| YouTube Email Finder API | Email aziendali pubbliche di un canale e le pagine in cui sono state trovate | 15 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.
Perché due esecuzioni di Trending Shorts restituiscono Shorts diversi?
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