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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL obbligatori di canali YouTube pubblici, separati da virgole o da a capo. I percorsi supportati iniziano con @handle, /channel/, /c/ o /user/. |
results_limit | Facoltativo | Numero 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.
- Prepara URL completi di canali YouTube pubblici con un percorso @handle, /channel/, /c/ o /user/.
- Invia con POST urls e un results_limit da 20 a 2000 a /v1/youtube/community-posts.
- Conserva il task_id restituito e interroga GET /v1/tasks/{task_id} finché l’attività è in stato queued, running o retrying.
- 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 trueCasi 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.
API correlate
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.
- YouTube Comments API
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API