x/
community-posts

Ottieni i post pubblici dai link delle community di X, con testo dei post, autori e conteggi di engagement restituiti insieme e un limite di risultati separato per ogni community.

X Community Posts API

Leggi le discussioni delle community
Testo dei post e autori
Un limite per ogni community
0,7 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

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

ParametriObbligatorioDescrizione
urlsObbligatorioElenco 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_limitFacoltativoNumero 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

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.

Esplora altre piattaforme

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

X Community Posts API — FAQ

X Community Posts API è un’interfaccia programmatica per leggere i post pubblici da un elenco di link di community di X. Restituisce testo dei post, autori, media, timestamp e conteggi di interazione in ordine di data di creazione, con un limite di risultati per ogni community.

Una community raggruppa i post condivisi all’interno di quello spazio di discussione, mentre la timeline di un profilo raggruppa i post di un solo account. Qui fornisci i link delle community; usa X User Posts quando il punto di partenza è il nome utente di un account.

No. Significa fino a 100 post per ogni link di community. Per esempio, tre community possono richiedere fino a 300 post in totale, anche se la disponibilità pubblica e la deduplicazione possono ridurre il numero finale di record.

Il limite deve procedere a passi di 20, quindi usa valori come 20, 40, 60 o 100. L’intervallo consentito va da 20 a 2.000 e il valore predefinito è 100.

No. Il cursore di un’attività ti permette di leggere un’altra pagina dei risultati che quell’attività ha già salvato. Non aumenta il limite originale per community e non avvia una nuova raccolta.

No. Restituisce record di post che puoi leggere, organizzare o passare a un processo di sintesi separato. Un riepilogo o un’analisi finita non fa parte della risposta.

Ogni post restituito costa 0,7 crediti, senza costo di base. Due link di community con un limite di 100 stimano 140 crediti; se l’attività restituisce 30 post in totale, il costo finale è di 21 crediti.