x/
article

Estrai il testo completo degli Articoli di X dagli URL dei post che li pubblicano, con titolo, anteprima nella timeline, immagine di copertina, autore ed engagement, mantenendo la divisione in paragrafi.

X Articles API

Input con URL del post
Testo completo dell’Articolo
Titolo, anteprima e copertina
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 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

ParametriObbligatorioDescrizione
urlsObbligatorioUno 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.

  1. Invia con POST {"urls": ["https://x.com/USDOL/status/2119796255089947070"]} a /v1/x/article.
  2. Interroga GET /v1/tasks/{task_id} finché lo stato dell’attività non diventa succeeded.
  3. 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.

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.

Esplora altre piattaforme

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

X Articles API — FAQ

X Articles API è un’interfaccia programmatica per leggere gli Articoli di X, i post di formato lungo con titolo e immagine di copertina, a partire dagli URL dei post che li pubblicano. Restituisce titolo, anteprima nella timeline, testo completo, URL dell’immagine di copertina, autore e numero di Mi piace, risposte, citazioni e visualizzazioni.

Gli Articoli di X sono post di formato lungo che gli abbonati Premium possono pubblicare su X, con un titolo, un’immagine di copertina e un testo formattato. Compaiono nelle timeline come post con una breve anteprima e i lettori li aprono per vedere il testo completo.

Usa il link del post che pubblica l’Articolo, nel formato x.com/{username}/status/{post_id}. Puoi inserire più link in urls contemporaneamente e ogni Articolo torna come riga a sé.

Quel post non restituisce alcuna riga e non costa nulla, mentre gli Articoli della stessa richiesta vengono comunque restituiti. Se nessuno degli URL è un Articolo, l’attività non riesce e viene rimborsata per intero.

L’immagine di copertina viene restituita in cover_url. Le immagini inserite nel testo non sono incluse; text contiene solo il contenuto scritto.

Sì. text contiene l’intero testo in formato semplice con una riga vuota tra i paragrafi, che puoi salvare come file .txt o usare come paragrafi Markdown, aggiungendo title in cima come intestazione.