x/
post-retweeters

Raccogli i profili pubblici normalizzati degli account che hanno ripubblicato post noti di X o Twitter, con deduplicazione a livello di attività, segnali visibili dell’account e metriche del profilo.

X Post Retweeters API

Pubblico dei repost
Profili pubblici
Deduplicazione a livello di attività
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 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

ParametriObbligatorioDescrizione
urlsObbligatorioURL 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_limitFacoltativoNumero 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.

  1. Prepara uno o più URL pubblici x.com o twitter.com i cui percorsi contengono /status/{numeric_post_id}.
  2. Invia con POST urls con un results_limit da 100 a 2.000 a passi di 100.
  3. Interroga /v1/tasks/{task_id} finché lo stato è succeeded o failed.
  4. 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_cursor

Casi 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.

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.

Esplora altre piattaforme

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

X Post Retweeters API — FAQ

X Post Retweeters API recupera i record normalizzati dei profili pubblici degli account osservati mentre ripubblicano uno o più post noti di X o Twitter.

Invia URL http o https su x.com, www.x.com, m.x.com, mobile.x.com, twitter.com, www.twitter.com, m.twitter.com o mobile.twitter.com con un percorso che contiene /status/{numeric_post_id}.

Il limite si applica in modo indipendente a ogni post di origine, ha come valore predefinito 100 e deve essere un multiplo di 100 tra 100 e 2.000.

Un risultato può includere ID del profilo, nome utente, nome, URL canonico, biografia, avatar, copertina, segnali di verifica e privacy, metriche visibili, ora di creazione dell’account, orario di raccolta e altri segnali pubblici dell’account.

No. I risultati sono record normalizzati di profilo di chi ha fatto repost; non includono oggetti repost, commenti aggiunti né contenuti di post con citazione.

No. I profili vengono deduplicati nell’attività e il record normalizzato non conserva l’URL né l’ID del post di origine. Invia un post per attività quando serve questa attribuzione.

results_limit è un tetto. Un post può avere meno retweeter visibili, la paginazione della raccolta può terminare, gli account non disponibili possono mancare e lo stesso profilo viene salvato una sola volta nell’attività.

L’utilizzo finale è di 0,5 crediti per profilo salvato univoco, senza costo di base. La stima prepagata usa il numero di URL inviati e il results_limit per post, mentre un risultato vuoto costa zero crediti.