x/
post-retweeters

Recopile perfiles públicos normalizados de las cuentas que hicieron repost de posts conocidos de X o Twitter, con deduplicación a nivel de tarea, señales visibles de la cuenta y métricas del perfil.

X Post Retweeters API

Audiencias de reposts
Perfiles públicos
Deduplicación a nivel de tarea
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

X Post Retweeters

Los registros de X Post Retweeters identifican las cuentas públicas que hicieron repost de URL de estado conocidas de X o Twitter y normalizan su identidad de perfil, sus señales públicas de cuenta, sus contadores visibles y la hora de recopilación. Cada post de origen se recorre de forma independiente y luego los perfiles guardados se deduplican en toda la tarea, sin conservar en cada resultado la atribución al post de origen.

Funcionalidades de la X Post Retweeters API

  • Resolución de URL de estadoAcepta URL de estado públicas de x.com y twitter.com y resuelve el identificador numérico del post que se necesita para recopilar la lista visible de quienes hicieron repost.
  • Perfiles de cuentas normalizadosDevuelve el ID del perfil, el nombre de usuario, el nombre visible, la URL canónica del perfil, la biografía, el avatar, la portada y los indicadores públicos de la cuenta cuando están disponibles.
  • Métricas visibles del perfilCaptura los conteos disponibles de seguidores, seguidos, posts, contenido multimedia y Me gusta, junto con las marcas de tiempo de creación de la cuenta y de recopilación.
  • Conjunto de resultados único para varios postsRecorre cada post enviado con su propio tope de resultados y luego guarda cada perfil normalizado una sola vez en toda la tarea completada.

Parámetros de la X Post Retweeters API

ParámetrosObligatorioDescripción
urlsObligatorioURL de estado públicas obligatorias de x.com o twitter.com que contengan un ID de post numérico; separe varios valores con comas o saltos de línea.
results_limitOpcionalMáximo de perfiles que se solicitan de forma independiente para cada post de origen; el valor predeterminado es 100 y se aceptan múltiplos de 100 de 100 a 2,000.

Cómo usar la X Post Retweeters API

Envíe URL de estado públicas conocidas como tarea asíncrona, consulte su estado y recorra después por páginas los resultados únicos de perfiles normalizados.

  1. Prepare una o más URL públicas de x.com o twitter.com cuyas rutas contengan /status/{numeric_post_id}.
  2. Envíe por POST urls con un results_limit de 100 a 2,000 en incrementos de 100.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. Lea /v1/tasks/{task_id}?limit=50 y pase results.next_cursor mientras results.has_more sea 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

Casos de uso de la X Post Retweeters API

  • Descubrimiento de audiencias de amplificación: Cree un directorio único de cuentas públicas que amplificaron posts seleccionados, para investigación, revisión o preparación de acciones de contacto.
  • Enriquecimiento de perfiles de quienes hicieron repost: Agregue perfiles canónicos, biografías, imágenes, indicadores públicos de la cuenta, ubicaciones, sitios web y métricas visibles a un conjunto de datos de amplificación.
  • Superposición de audiencias entre posts: Ejecute un post de origen por tarea y compare los ID de perfil estables entre los conjuntos de resultados completados cuando importen la superposición o la atribución por post.

Consejos de expertos para la X Post Retweeters API

  • Canonice las URL de estado y deduplique por ID numérico de post antes de enviar el lote, porque no se garantiza que distintas formas de URL del mismo post se unifiquen en la validación de entrada.
  • Trate results_limit como un tope por post de origen y no como una cantidad garantizada de resultados; la visibilidad pública y la paginación disponible pueden producir menos perfiles.
  • Use una URL de origen por tarea cuando importe la atribución al origen, porque los resultados de perfiles normalizados no conservan la URL ni el ID del post de origen.
  • Siga el results.next_cursor opaco de la tarea de forma independiente de la paginación de la recopilación; el cursor público recorre los resultados normalizados ya guardados.
  • Use el ID del perfil como clave de combinación duradera entre tareas y asocie los contadores públicos cambiantes a collected_at.
  • Admita campos de perfil nulos y resultados vacíos, porque las biografías, las imágenes, las señales de la cuenta, los contadores o la visibilidad de quienes hicieron repost pueden no estar disponibles.

Además de la X Post Retweeters API, use estas APIs cuando necesite otro tipo de datos públicos de X.

  • Twitter Tweet Scraper API — Obtiene el texto de posts públicos, autores, interacción, contenido multimedia, hashtags, menciones y relaciones de conversación desde URLs de estado de x.com o twitter.com.
  • Twitter Profile Scraper API — Obtiene por nombre de usuario la identidad de la cuenta pública, biografías, avatares, imágenes de portada, estado de la cuenta y estadísticas visibles de audiencia.
  • X Followers List API — Recolecta las identidades de las cuentas seguidoras públicas y las métricas visibles de sus perfiles para uno o más nombres de usuario de X.
  • X Following List API — Recolecta los perfiles seguidos por cuentas públicas de X, incluyendo identidad, biografías, señales de la cuenta, contadores visibles y nombres de usuario de origen.
  • X Post Quotes API — Recolecta posts públicos con cita de URLs de estado conocidas, con comentario, autores, interacción, contenido multimedia, marcas de tiempo y contexto del post de origen.
  • X Community API — Lee enlaces de comunidades para obtener descripciones, cantidad de miembros, reglas y políticas de ingreso.

Explorar otras plataformas

Combine los datos de X con datos públicos de otras plataformas sociales compatibles.

X Post Retweeters API — FAQ

X Post Retweeters API recupera registros de perfiles públicos normalizados de las cuentas que hicieron repost de uno o más posts conocidos de X o Twitter.

Envíe URL http o https de x.com, www.x.com, m.x.com, mobile.x.com, twitter.com, www.twitter.com, m.twitter.com o mobile.twitter.com con una ruta que contenga /status/{numeric_post_id}.

El límite se aplica de forma independiente a cada post de origen, su valor predeterminado es 100 y debe ser un múltiplo de 100 entre 100 y 2,000.

Un resultado puede incluir el ID del perfil, el nombre de usuario, el nombre, la URL canónica, la biografía, el avatar, la portada, las señales de verificación y privacidad, las métricas visibles, la fecha de creación de la cuenta, la hora de recopilación y otras señales públicas de la cuenta.

No. Los resultados son registros de perfiles normalizados de las cuentas observadas; no incluyen objetos de repost, comentarios agregados ni contenido de posts de cita.

No. Los perfiles se deduplican en toda la tarea y el registro normalizado no conserva la URL ni el ID de su post de origen. Envíe un post por tarea cuando necesite esa atribución.

results_limit es un tope. Un post puede tener menos cuentas visibles que hicieron repost, la paginación de la recopilación puede terminar, las cuentas no disponibles pueden faltar y un mismo perfil se guarda una sola vez en toda la tarea.

El uso final es de 0.5 créditos por perfil único guardado, sin cargo base. La estimación del cobro por adelantado usa la cantidad de URL enviadas y el results_limit por post, y un resultado vacío cuesta cero créditos.