youtube/
community-posts

Raccogli i post della community pubblici di YouTube dagli URL dei canali, con testo dei post, identità del canale, timestamp, riferimenti alle immagini e contesto di origine come record normalizzati.

YouTube Community Posts API

Scheda Community
Input con URL del canale
Riferimenti alle immagini
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 Community Posts

I post della community di YouTube sono aggiornamenti pubblici della scheda di un canale, con testo del post, identità del canale autore, ora di pubblicazione, link pubblici e immagini allegate. Questi record supportano gli inventari dei feed dei canali, la revisione degli annunci e l’analisi delle pubblicazioni tra più canali.

Funzionalità della YouTube Community Posts API

  • Raccolta da più URL di canaliAccetta URL completi di canali pubblici con percorsi @handle, /channel/, /c/ o /user/ e applica il tetto di risultati scelto in modo indipendente a ogni canale.
  • Record dei post normalizzatiRestituisce ID dei post pubblici, URL della community, testo, timestamp di pubblicazione e di raccolta in una struttura coerente.
  • Contesto dal canale al postMantiene ogni post collegato a ID del canale, handle, nome visualizzato, URL pubblico del canale e URL di origine inviato.
  • Riferimenti alle immagini allegateMappa le immagini esposte dei post in voci multimediali normalizzate, così gli aggiornamenti basati su immagini restano collegati ai rispettivi record dei post.
  • Scansione del feed con limitiSegue le pagine di continuazione della fonte per ogni canale, rimuove i post duplicati per ID o URL e si ferma al limite scelto, alla fine del feed o al tetto di 100 pagine.

Parametri della YouTube Community Posts API

ParametriObbligatorioDescrizione
urlsObbligatorioURL obbligatori di canali YouTube pubblici, separati da virgole o da a capo. I percorsi supportati iniziano con @handle, /channel/, /c/ o /user/.
results_limitFacoltativoNumero massimo di post della community da raccogliere per ogni canale in input. Il valore predefinito è 100 e sono accettati interi da 20 a 2000.

Come usare la YouTube Community Posts API

Invia uno o più canali pubblici noti come attività asincrona, poi leggi i record salvati dei post della community al termine.

  1. Prepara URL completi di canali YouTube pubblici con un percorso @handle, /channel/, /c/ o /user/.
  2. Invia con POST urls e un results_limit da 20 a 2000 a /v1/youtube/community-posts.
  3. Conserva il task_id restituito e interroga GET /v1/tasks/{task_id} finché l’attività è in stato queued, running o retrying.
  4. Dopo il successo leggi data.results.items e passa data.results.next_cursor come cursor nella richiesta dell’attività finché data.results.has_more è true.
curl -X POST "https://api.socq.ai/v1/youtube/community-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@YouTube"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass data.results.next_cursor as cursor while has_more is true

Casi d’uso della YouTube Community Posts API

  • Inventario del feed Community dei canali: Usa ID dei post, URL, testo, timestamp e contesto del canale di origine per costruire un feed verificabile a partire da canali pubblici selezionati.
  • Revisione di annunci e creatività: Esamina il testo dei post pubblici insieme ai riferimenti alle immagini conservati, per confrontare come i canali presentano gli aggiornamenti al di fuori dei loro feed di video.
  • Analisi delle pubblicazioni tra canali: Raggruppa i post normalizzati per identità del canale e ora di pubblicazione per confrontare l’attività di pubblicazione nella community su un insieme noto di canali.

Consigli degli esperti per la YouTube Community Posts API

  • Invia un URL di canale completo su un host YouTube supportato; i valori di video, post, playlist e le stringhe che non sono URL non rispettano la specifica di input dei canali pubblici.
  • Dimensiona con cura le richieste su più canali, perché results_limit si applica a ogni URL: tre canali con 20 possono richiedere fino a 60 post salvati.
  • Considera results_limit come un tetto, perché un canale senza una scheda Community pubblica o con un feed visibile più breve può restituire meno record.
  • Usa cursor solo con GET /v1/tasks/{task_id}; la continuazione della fonte è gestita internamente e non è un parametro di richiesta pubblico per questo endpoint.
  • Deduplica i record archiviati per ID del post, ripiegando sull’URL, e conserva extra.input_url quando combini più canali inviati.
  • Controlla text, media e created_at prima dell’uso a valle; i record normalizzati attuali non conservano le opzioni dei sondaggi né i metadati dei video incorporati come allegato.

Oltre alla YouTube Community Posts 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 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 Community Post API — Legge un singolo post della community dal suo link, con testo completo, immagini allegate, Mi piace e canale che l’ha pubblicato.
  • YouTube Community Post Comments API — Raccoglie i commenti dal link di un post della community, con i canali di chi commenta, numero di Mi piace e numero di risposte.

Esplora altre piattaforme

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

YouTube Community Posts API — FAQ

YouTube Community Posts API è un’interfaccia programmatica per raccogliere i post pubblici della scheda Community da URL di canali YouTube supportati. Restituisce ID dei post, URL, testo, identità del canale, timestamp, riferimenti alle immagini e contesto del canale di origine.

Usa URL completi di youtube.com il cui primo segmento di percorso sia @handle, /channel/, /c/ o /user/. Gli URL di video, post, playlist e di host non correlati non sono accettati come input dei canali.

results_limit ha 100 come valore predefinito, accetta interi da 20 a 2000 e si applica separatamente a ogni URL di canale inviato. Due canali con 100 possono quindi richiedere fino a 200 record di post salvati.

Un record può includere ID e URL del post, testo pubblico, ID, handle, nome e URL del canale, campi dei contatori normalizzati, riferimenti alle immagini conservati, orari di pubblicazione e di raccolta ed extra.input_url.

Le immagini esposte possono essere conservate come riferimenti multimediali normalizzati. Lo schema di risposta attuale non conserva le opzioni dei sondaggi, le percentuali di voto né i dettagli dei video incorporati come allegato.

No. Restituisce i record dei post pubblici della community e non espande i thread di commenti sotto di essi.

Il canale potrebbe non avere una scheda Community pubblica, il suo feed visibile può terminare prima di results_limit, oppure i post possono essere eliminati, riservati ai membri, privati o limitati dall’accesso.

No. Il collector segue internamente i token di continuazione della fonte per ogni canale. Il cursore restituito da un’attività completata con successo scorre solo i record normalizzati già salvati per quell’attività.

Ogni post normalizzato salvato costa 0,5 crediti. La stima iniziale moltiplica il results_limit per canale per il numero di URL inviati, mentre la fatturazione finale segue il numero effettivo di record salvati.