X Articles
Gli Articoli di X, spesso chiamati ancora articoli di Twitter, sono post di formato lungo che gli abbonati Premium pubblicano con un titolo, un’immagine di copertina e un testo formattato, mostrati nelle timeline come breve anteprima e capaci di raccogliere Mi piace, risposte, citazioni e visualizzazioni come qualsiasi altro post. Avere titolo, anteprima e testo completo accanto a quei conteggi permette di archiviare i contenuti di formato lungo, riassumerli o classificarli e confrontare il rendimento degli Articoli con quello dei post abituali di un autore.
Funzionalità della X Articles API
- Post con Articoli tramite URLInvia uno o più link ai tweet che pubblicano Articoli, nel formato x.com/{username}/status/{post_id}, e ogni Articolo restituisce una riga il cui id e url appartengono a quel post.
- Testo completo in formato semplicetext contiene l’intero Articolo con una riga vuota tra un paragrafo e l’altro, pronto da dividere in paragrafi o da passare a un lettore, a un indice di ricerca o a un modello linguistico.
- Titolo, riga di anteprima e immagine di copertinatitle, summary (l’anteprima che X mostra nelle timeline) e cover_url descrivono l’Articolo così come i lettori lo incontrano per la prima volta nel loro feed.
- Autore ed engagementauthor fornisce handle, nome visualizzato, avatar e flag di verifica, metrics fornisce Mi piace, risposte, citazioni e visualizzazioni, e published_at registra quando l’Articolo è stato pubblicato.
Parametri della X Articles API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Uno o più URL di post di X nel formato /{username}/status/{post_id}, ciascuno riferito al post che pubblica un Articolo. |
Come usare la X Articles API
Invia i link dei post che contengono gli Articoli e leggi una riga per ogni Articolo.
- Invia con POST {"urls": ["https://x.com/USDOL/status/2119796255089947070"]} a /v1/x/article.
- Interroga GET /v1/tasks/{task_id} finché lo stato dell’attività non diventa succeeded.
- Leggi gli Articoli da results.items; finché has_more è true, invia results.next_cursor per ottenere la pagina successiva.
curl -X POST "https://api.socq.ai/v1/x/article" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/USDOL/status/2119796255089947070"]}'
# text holds the whole Article, with a blank line between paragraphs.Casi d’uso della X Articles API
- Archiviare i contenuti di formato lungo di un autore: Salva title, text, cover_url, published_at e url di ogni Articolo per conservare una copia consultabile di ciò che un account ha pubblicato in formato lungo.
- Riassumere gli Articoli con un modello linguistico: Dividi text in corrispondenza delle righe vuote e passa i paragrafi a uno strumento di sintesi o a un modello linguistico, con title come contesto, per trasformare Articoli lunghi in brevi riepiloghi.
- Confrontare gli Articoli con i post abituali di un autore: Metti views_count, likes_count e quotes_count degli Articoli di un autore accanto agli stessi conteggi dei suoi post abituali per capire quale formato il suo pubblico legge e rilancia.
- Seguire un Articolo dopo la pubblicazione: Richiedi lo stesso URL a intervalli regolari e registra come crescono visualizzazioni, risposte e citazioni nei giorni successivi a published_at.
- Citare gli annunci parola per parola: Quando un ente, un’azienda o un fondatore pubblica un annuncio come Articolo, riprendi passaggi esatti da text e citali con url e published_at.
Consigli degli esperti per la X Articles API
- Se non sai quali post sono Articoli, inviali in un unico batch: solo gli Articoli restituiscono righe e vengono addebitati, mentre un batch composto interamente da post normali non riesce e viene rimborsato per intero.
- Mostra summary nelle anteprime e nelle schede e text nella vista di lettura; summary ripete le prime righe del testo, quindi unire i due campi stampa quel passaggio due volte.
- Salva ogni Articolo sotto id, l’ID del post che lo pubblica, così raccogliere di nuovo lo stesso Articolo aggiorna le metriche salvate.
- Riporta metrics.comments_count come numero di risposte al post dell’Articolo quando inserisci l’engagement degli Articoli in una dashboard.
API correlate
Oltre alla X Articles 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 Profile Scraper API — Recupera identità dell’account pubblico, bio, avatar, immagini di copertina, stato dell’account e statistiche visibili del pubblico a partire dal nome utente.
- 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 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
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API