x/
post-quotes

Raccogli i post con citazione pubblici per URL noti di status di X, con commento, identità dell’autore, media, timestamp, contesto della conversazione e metriche di engagement visibili.

X Post Quotes API

Commento della citazione
Contesto del post di origine
Limiti per post
0,5 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 Post Quotes

X Post Quotes raccoglie i post con citazione pubblici relativi a specifici post di X e restituisce identità dell’autore, commento della citazione, media, ora di pubblicazione e dati di engagement visibili per il monitoraggio delle opinioni, l’analisi del sentiment e la valutazione delle prestazioni di distribuzione.

Funzionalità della X Post Quotes API

  • Espansione dei post con citazioneParti da uno o più URL pubblici di status e raccogli i post pubblici che citano quelle fonti, e non le risposte né i profili dei semplici repost.
  • Limiti indipendenti per fonteRichiedi da 20 a 2.000 record per post di origine a passi di 20, mentre ogni status inviato avanza con il proprio cursore del provider.
  • Record di commento normalizzatiRicevi testo della citazione, lingua, identità dell’autore, orari di pubblicazione e di raccolta, media, entità ed engagement visibile in un’unica forma coerente.
  • Tracciamento della fonte e deduplicazioneConserva in extra l’URL inviato e l’ID del post padre, mentre gli ID ripetuti dei post con citazione vengono salvati una sola volta nell’attività.

Parametri della X Post Quotes API

ParametriObbligatorioDescrizione
urlsObbligatorioURL pubblici di status di x.com o twitter.com obbligatori. Le varianti di host supportate devono contenere un ID numerico del post dopo /status/.
results_limitFacoltativoMassimo facoltativo per ogni post di origine inviato. Il valore predefinito è 100 e deve essere un multiplo di 20 da 20 a 2.000.

Come usare la X Post Quotes API

Invia URL pubblici noti di status, poi interroga l’attività asincrona e scorri i relativi record normalizzati dei post con citazione.

  1. Prepara URL pubblici x.com o twitter.com il cui percorso contiene /status/{numeric_id}.
  2. Invia con POST l’array urls a /v1/x/post-quotes con un results_limit facoltativo, poi salva il task_id.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce.
  4. Leggi data.results.items e riutilizza next_cursor finché has_more è true; questo cursore dei risultati è separato dalla paginazione del provider.
X_POST_URL="https://x.com/OpenAI/status/1950240351547248941"

curl -X POST "https://api.socq.ai/v1/x/post-quotes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"urls\":[\"${X_POST_URL}\"],\"results_limit\":100}"

# Poll GET /v1/tasks/{task_id}?limit=50
# Follow data.results.next_cursor while data.results.has_more is true

Casi d’uso della X Post Quotes API

  • Studia i commenti aggiunti: Crea un insieme di revisione di ciò che gli autori pubblici hanno aggiunto quando hanno citato il lancio di un prodotto, un annuncio, un link di ricerca o un post di campagna.
  • Individua gli amplificatori pubblici: Confronta gli autori delle citazioni e l’engagement visibile per trovare gli account la cui impostazione ha generato una risposta pubblica rilevante.
  • Archivia istantanee dei post con citazione: Conserva commenti, riferimenti ai media, timestamp e contatori al momento della raccolta per un elenco definito di post di origine.

Consigli degli esperti per la X Post Quotes API

  • Convalida l’hostname e l’ID numerico /status/ prima dell’invio; i link a profili, ricerche e altre pagine che non sono status vengono rifiutati.
  • Calcola results_limit per post di origine e non per attività: due URL a 100 possono stimare fino a 200 record.
  • Aspettati che lo stesso ID di post con citazione compaia una sola volta nei risultati salvati dell’attività, anche se più fonti inviate portano a esso.
  • Considera il limite richiesto un tetto e non una garanzia di completezza, perché post eliminati, protetti, limitati o esclusi dalla ricerca possono mancare.
  • Salva in modo difensivo i campi nullable di media, entità, conversazione ed engagement e usa collected_at quando confronti contatori che cambiano.

Oltre alla X Post Quotes 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 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.
  • X Post Retweeters API — Raccoglie un insieme unico, a livello di attività, di profili pubblici normalizzati degli account che hanno fatto repost di URL di stato X o Twitter noti.
  • Twitter Mentions API — Raccoglie i post pubblici che menzionano un account indicato.
  • X Community Posts API — Leggi i post pubblici condivisi in una community, con testo, autori e conteggi delle interazioni.

Esplora altre piattaforme

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

X Post Quotes API — FAQ

X Post Quotes API è un’interfaccia programmatica per raccogliere i post con citazione pubblici che fanno riferimento a URL noti di status di X. Restituisce commenti normalizzati, autori, engagement, media, timestamp e contesto del post di origine.

Fornisci un array urls non vuoto di link pubblici x.com o twitter.com il cui percorso contiene /status/ seguito da un ID numerico del post.

La raccolta riguarda i post con citazione restituiti per ogni status di origine. Le risposte e gli account che hanno solo ripubblicato la fonte sono gestiti da risorse separate.

Il valore predefinito è 100 per ogni URL di origine inviato e sono accettati multipli di 20 da 20 a 2.000. I risultati pubblici disponibili possono essere meno del tetto richiesto.

Le pagine del provider vengono deduplicate per ID del post per ogni fonte e la persistenza salva lo stesso ID normalizzato di post con citazione una sola volta nell’attività.

L’attività stima 0,5 crediti per ogni risultato richiesto tra gli URL inviati, poi si chiude a 0,5 crediti per risultato salvato univoco e rimborsa i crediti prepagati non utilizzati.