X Post Retweeters
I record di X Post Retweeters identificano gli account pubblici osservati mentre ripubblicano URL di status noti di X o Twitter e normalizzano la loro identità di profilo, i segnali pubblici dell’account, i contatori visibili e l’orario di raccolta. I post di origine multipli vengono percorsi in modo indipendente, poi i profili salvati vengono deduplicati nell’intera attività senza conservare in ogni risultato l’attribuzione al post di origine.
Funzionalità della X Post Retweeters API
- Risoluzione degli URL di statusAccetta URL pubblici di status di x.com e twitter.com e risolve l’identificatore numerico del post necessario per raccogliere l’elenco visibile di chi ha fatto repost.
- Profili di account normalizzatiRestituisce ID del profilo, nome utente, nome visualizzato, URL canonico del profilo, biografia, avatar, copertina e flag pubblici dell’account quando disponibili.
- Metriche visibili del profiloAcquisisce i conteggi disponibili di follower, seguiti, post, media e Mi piace insieme ai timestamp di creazione dell’account e di raccolta.
- Insieme di risultati univoco su più postPercorre ogni post inviato con il proprio limite di risultati, poi salva ogni profilo normalizzato una sola volta nell’attività completata.
Parametri della X Post Retweeters API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL pubblici obbligatori di status di x.com o twitter.com che contengono un ID numerico del post; separa più valori con virgole o a capo. |
results_limit | Facoltativo | Numero massimo di profili richiesti in modo indipendente per ogni post di origine; il valore predefinito è 100 e sono accettati multipli di 100 da 100 a 2.000. |
Come usare la X Post Retweeters API
Invia URL pubblici noti di status come attività asincrona, interroga il suo stato, poi scorri i risultati univoci dei profili normalizzati.
- Prepara uno o più URL pubblici x.com o twitter.com i cui percorsi contengono /status/{numeric_post_id}.
- Invia con POST urls con un results_limit da 100 a 2.000 a passi di 100.
- Interroga /v1/tasks/{task_id} finché lo stato è succeeded o failed.
- Leggi /v1/tasks/{task_id}?limit=50 e passa results.next_cursor finché results.has_more è true.
curl -X POST "https://api.socq.ai/v1/x/post-retweeters" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursorCasi d’uso della X Post Retweeters API
- Scoperta del pubblico che amplifica: Crea una directory univoca di account pubblici osservati mentre amplificano post selezionati, per ricerca, revisione o preparazione di attività di contatto.
- Arricchimento dei profili di chi fa repost: Aggiungi profili canonici, biografie, immagini, flag pubblici dell’account, posizioni, siti web e metriche visibili a un dataset di amplificazione.
- Sovrapposizione del pubblico tra post: Esegui un post di origine per attività e confronta gli ID stabili dei profili tra gli insiemi di risultati completati quando contano la sovrapposizione o l’attribuzione per post.
Consigli degli esperti per la X Post Retweeters API
- Rendi canonici gli URL di status e deduplica per ID numerico del post prima di creare i batch, perché forme diverse di URL dello stesso post non sono garantite come unificate nella convalida dell’input.
- Considera results_limit un tetto per post di origine e non un numero garantito di risultati; la visibilità pubblica e la paginazione disponibile possono produrre meno profili.
- Usa un URL di origine per attività quando conta l’attribuzione alla fonte, perché i risultati normalizzati dei profili non conservano l’URL né l’ID del post di provenienza.
- Segui il results.next_cursor opaco dell’attività in modo indipendente dalla paginazione della raccolta; il cursore pubblico scorre i risultati normalizzati già salvati.
- Usa l’ID del profilo come chiave di unione duratura tra le attività e ancora i contatori pubblici variabili a collected_at.
- Ammetti campi del profilo nullable e risultati vuoti, perché biografie pubbliche, immagini, segnali dell’account, contatori o la visibilità di chi ha fatto repost possono non essere disponibili.
API correlate
Oltre alla X Post Retweeters 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.
- X Followers List API — Raccoglie identità degli account follower pubblici e metriche visibili dei profili per uno o più nomi utente X.
- X Following List API — Raccoglie i profili seguiti dagli account X pubblici, inclusi identità, bio, segnali dell’account, contatori visibili e nomi utente di origine.
- 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 Community API — Leggi i link delle community per descrizioni, numero di membri, regole e criteri di ingresso.
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search 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 Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API