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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL 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_limit | Opcional | Má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.
- Prepare una o más URL públicas de x.com o twitter.com cuyas rutas contengan /status/{numeric_post_id}.
- Envíe por POST urls con un results_limit de 100 a 2,000 en incrementos de 100.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- 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_cursorCasos 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.
APIs relacionadas
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.
- 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