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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL 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_limit | Facoltativo | Massimo 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.
- Prepara URL pubblici x.com o twitter.com il cui percorso contiene /status/{numeric_id}.
- Invia con POST l’array urls a /v1/x/post-quotes con un results_limit facoltativo, poi salva il task_id.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o fallisce.
- 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 trueCasi 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.
API correlate
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.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Trends API
- Twitter User Search API
- X Community 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 Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API