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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL di liste pubbliche di X nel formato https://x.com/i/lists/<numeric id>. La timeline di ogni lista viene raccolta separatamente. |
results_limit | Facoltativo | Post 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.
- Invia con POST {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} a /v1/x/list-posts.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- 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.
API correlate
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.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers 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