x/
list-posts

Raccogli i post e i repost più recenti dalle timeline delle liste pubbliche di X tramite l’URL della lista, con testo, autore, Mi piace, visualizzazioni, media e un flag di repost su ogni elemento, dal più recente.

X List Tweets API

Input con URL della lista
Repost contrassegnati
Post più recenti per primi
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 List Tweets

La timeline di una lista di X è il feed dei tweet e dei retweet degli account che qualcuno ha raggruppato in una lista, ciascuno con testo, autore, Mi piace, commenti, repost, visualizzazioni, immagini o video allegati, hashtag e menzioni. Letti insieme, questi post ti permettono di seguire di cosa parla un gruppo selezionato di giornalisti, fondatori o concorrenti, di vedere quali membri ottengono più engagement con i propri post e di scoprire di chi siano i contenuti che il gruppo continua a far circolare.

Funzionalità della X List Tweets API

  • La timeline di qualsiasi lista pubblica tramite URLInvia uno o più link x.com/i/lists/<id> e la timeline di ogni lista torna dal post più recente, fino a 2.000 tweet per lista.
  • Repost contrassegnati, autore originale tenuto a parteis_repost segnala ogni repost; author resta il membro della lista che l’ha condiviso, mentre reposted_author e reposted_post_id rimandano al creator e al post originali.
  • Engagement e media su ogni postmetrics contiene Mi piace, commenti, condivisioni e visualizzazioni, mentre media elenca ogni immagine o video con URL, miniatura, larghezza e altezza.
  • Hashtag e menzioni in array separatihashtags e mentions arrivano come elenchi a sé, così puoi contare direttamente dai campi gli argomenti di cui parla una lista e gli account a cui si rivolgono i suoi membri.

Parametri della X List Tweets API

ParametriObbligatorioDescrizione
urlsObbligatorioURL di liste pubbliche di X nel formato https://x.com/i/lists/<numeric id>. La timeline di ogni lista viene raccolta separatamente.
results_limitFacoltativoPost da raccogliere da ogni lista, un multiplo di 20 da 20 a 2.000. Il valore predefinito è 100.

Come usare la X List Tweets API

Invia gli URL delle liste, attendi la fine dell’attività e leggi la timeline pagina per pagina.

  1. Invia con POST {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} a /v1/x/list-posts.
  2. Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
  3. Leggi i post da results.items, dal più recente, e rimanda results.next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/x/list-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'

# Reposts arrive with is_repost set to true and the original creator in reposted_author.

Casi d’uso della X List Tweets API

  • Seguire un settore attraverso una lista curata: Scarica ogni mattina la timeline di una lista di giornalisti o analisti e leggi text, author e published_at per vedere di cosa si è occupato il gruppo dall’ultima esecuzione.
  • Classificare i post a cui reagisce una nicchia: Tieni i post originali (is_repost false) e ordinali per views_count e likes_count per scoprire quali aggiornamenti dei membri hanno attirato più attenzione.
  • Misurare chi viene amplificato da un gruppo: Conta reposted_author.username tra i repost per vedere quali account esterni e quali altri membri la lista rilancia più spesso.
  • Raccogliere gli annunci dei concorrenti in un solo feed: Inserisci gli account dei brand concorrenti in una lista e raccogline la timeline per catturare insieme i loro post di lancio, i link e i media allegati.
  • Costruire un dataset di argomenti per una community: Raggruppa per published_at gli hashtag e le menzioni dei post di una lista per tracciare quali argomenti e account la community discute nel tempo.

Consigli degli esperti per la X List Tweets API

  • Filtra su is_repost prima di classificare i membri per engagement, perché un repost riporta i Mi piace e le visualizzazioni del post originale.
  • Quando più membri ripostano lo stesso post, deduplica su reposted_post_id in modo da contare ogni originale una sola volta.
  • Alza results_limit quando ti servono molti post originali da una lista molto attiva, perché i repost possono occupare gran parte della sua timeline.
  • Il testo di un repost inizia con “RT @user:” e le sue menzioni includono quell’utente, quindi scarta i repost o rimuovi il prefisso prima di contare parole chiave e menzioni.
  • Nelle esecuzioni pianificate tieni solo gli elementi con un id nuovo per il tuo archivio, perché una timeline ordinata dal più recente si sovrappone all’esecuzione precedente.
  • Per vedere tutti gli account che alimentano la timeline, compresi i membri che pubblicano di rado, raccogli la stessa lista con Twitter List Members API.

Oltre alla X List Tweets 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.
  • X Post Replies API — Raccoglie le risposte pubbliche dagli URL dei post X con ordinamento selezionabile, testo delle risposte, autori, engagement visibile, media e contesto del post principale.
  • Twitter Mentions API — Raccoglie i post pubblici che menzionano un account indicato.
  • Twitter List Members API — Esporta gli account di una lista come profili completi con bio, località e contatori.

Esplora altre piattaforme

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

X List Tweets API — FAQ

X List Tweets API è un’interfaccia programmatica per raccogliere la timeline delle liste pubbliche di X a partire dai loro URL. Restituisce ogni post o repost con testo, autore, Mi piace, commenti, condivisioni, visualizzazioni, media, hashtag, menzioni e origine del repost.

Apri la lista su x.com, copia il suo URL (ha questo aspetto: https://x.com/i/lists/1940592907737845989) e invialo in urls. I post tornano dal più recente, nello stesso ordine della timeline della lista.

È il numero che segue /i/lists/ nell’URL della lista. Al momento dell’invio inserisci l’URL completo in urls.

Sì. I repost dei membri della lista vengono restituiti e contrassegnati con is_repost, con l’ID del post originale in reposted_post_id e il suo creator in reposted_author. Filtra su is_repost quando vuoi solo i post originali.

Un URL che rimanda a una lista inesistente restituisce un risultato vuoto; l’attività riesce comunque e non viene addebitato nulla. Controlla che il numero dopo /i/lists/ sia completo.

Sì. Aggiungi l’URL di ogni lista a urls. results_limit vale per ogni lista, quindi tre liste con limite 100 possono restituire fino a 300 post.