X Community Posts
I post delle community di X sono messaggi condivisi all’interno di una community tematica, ciascuno con autore, ora di pubblicazione, testo ed eventuali media allegati. Leggere quei post insieme ai loro conteggi di interazione aiuta a organizzare il materiale di discussione e a confrontare i singoli post che compongono la conversazione pubblica di una community.
Funzionalità della X Community Posts API
- Leggi i post della community che indichiParti dal link di una community per raccogliere le discussioni pubbliche al suo interno, invece dell’insieme dei post pubblicati sul profilo di una persona.
- Applica un limite separato a ogni communityQuando fornisci più link di community, results_limit si applica a ciascuna e i post vengono raccolti in ordine di data di creazione, così il tuo input specifica la dimensione della raccolta per ogni spazio di discussione.
- Tieni insieme il messaggio e i suoi dettagli di supportoOgni record di post contiene testo, informazioni sull’autore, ora di pubblicazione, media e conteggi di interazione disponibili, così puoi rivedere il messaggio senza perdere chi l’ha pubblicato e quando.
Parametri della X Community Posts API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di link pubblici di community di X con un ID numerico della community, come https://x.com/i/communities/1493446837214187523; nel Playground inserisci un link per riga, oppure nel codice usa un array JSON urls, e non il link di un profilo, di una ricerca o di un singolo post. |
results_limit | Facoltativo | Numero massimo facoltativo di post per community; il valore predefinito è 100 e sono accettati multipli di 20 da 20 a 2.000, come 20, 40 o 100; con due link di community e un limite di 20, ogni community può contribuire con fino a 20 post. |
Come usare la X Community Posts API
La richiesta avvia un’attività di raccolta in background, quindi la prima risposta contiene un ID attività e non i dati finali; usa quell’ID per controllare l’avanzamento e recuperare i risultati.
- Copia i link delle community che vuoi leggere e scegli un limite per community come 20 o 100; usa il link di una community e non l’URL di un singolo post.
- Prima di eseguire l’esempio, sostituisci $SOCQ_API_KEY con la tua chiave API oppure imposta quella variabile d’ambiente. Invia l’input JSON a POST /v1/x/community-posts con l’intestazione Authorization mostrata qui sotto, poi salva il task_id dalla risposta.
- Usa GET /v1/tasks/{task_id} con l’ID salvato per controllare l’avanzamento. queued significa in attesa, running significa raccolta in corso e retrying significa che è in corso un nuovo tentativo. Attendi succeeded prima di leggere i risultati; se l’attività è failed, leggi error_message per conoscere il motivo.
- Quando l’attività riesce, leggi data.results.items: ogni elemento di questo elenco descrive un post di una community. Un elenco vuoto significa che l’attività è terminata senza restituire alcun record.
- Se data.results.has_more è true, il valore next_cursor è il segnaposto per un’altra pagina di risultati salvati. Copialo senza modifiche nel parametro cursor di GET /v1/tasks/{task_id}?cursor=... e continua finché has_more è false.
curl -X POST "https://api.socq.ai/v1/x/community-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/communities/1493446837214187523"],"results_limit":20}'Casi d’uso della X Community Posts API
- Prepara il materiale di partenza per un riepilogo delle discussioni: Organizza il testo dei post recuperati, gli handle degli autori, i link e gli orari in un elenco di lettura che una persona o uno strumento di sintesi separato può usare per scrivere un riepilogo di quei post.
- Confronta i conteggi di interazione di un post tra istantanee salvate: Salva gli ID dei post e i contatori restituiti con gli orari di raccolta, poi associa gli stessi post nelle raccolte successive per calcolare tu stesso le variazioni dei conteggi disponibili.
- Approfondisci la conversazione intorno a un post selezionato: Scegli un post dai risultati della community e passa il suo URL a X Thread Context per leggere i post precedenti e le risposte disponibili intorno a quel messaggio specifico.
Consigli degli esperti per la X Community Posts API
- Quando pianifichi un batch, moltiplica il numero di link di community per results_limit per stimare il numero di record richiesti, poi usa la tariffa per post senza presumere che il limite sia condiviso da tutte le community.
- Quando ripeti una raccolta, associa i post tramite i loro ID prima di aggiungerli alla tua tabella salvata, perché un post può comparire di nuovo in un’attività successiva.
- Quando conservi i risultati di più community, salva i link delle community inviati insieme all’input dell’attività; il record standard del post non garantisce un ID della community che possa sostituire quel contesto di input.
API correlate
Oltre alla X Community Posts API, usa queste API quando ti serve un altro tipo di dati pubblici di X.
- Twitter Tweet Scraper API — Recupera testo dei post pubblici, autori, engagement, media, hashtag, menzioni e relazioni della conversazione dagli URL di stato di x.com o twitter.com.
- Twitter User Tweets Scraper API — Raccoglie i post pubblici recenti, autori, media, hashtag, menzioni ed engagement a partire dal nome utente, escludendo le risposte.
- X Post Quotes API — Raccoglie le citazioni pubbliche di URL di stato noti con commento, autori, engagement, media, date e contesto del post di origine.
- Twitter Mentions API — Raccoglie i post pubblici che menzionano un account indicato.
- X Thread Context API — Leggi un post con i messaggi precedenti della catena di risposte, le risposte pubbliche e gli ID delle relazioni.
- X List Tweets API — Legge la timeline di una lista a partire dal post più recente, con i repost segnalati e i rispettivi autori originali.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Account Location API
- X Verified Followers API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API