X Post Replies
Las respuestas a un post de X son respuestas públicas dentro de la conversación del post, con texto, identidad del autor, idioma, archivos multimedia, interacción visible, hora de publicación y enlaces a posts padre o relacionados. Estos registros de conversación sirven para analizar respuestas, reconstruir hilos, monitorear respuestas y preparar conjuntos de datos de clasificación.
Funcionalidades de la X Post Replies API
- Alcance de conversación de un post conocidoAcepta una o más URL de estado públicas de X, extrae el ID numérico de cada post y devuelve las respuestas, excluyendo el propio post padre enviado.
- Registros de respuestas y autoresDevuelve los ID de las respuestas, las URL canónicas, el texto, el idioma, las horas de publicación y la identidad pública normalizada del autor de cada respuesta guardada.
- Señales visibles de respuestaMantiene juntos los conteos públicos de Me gusta, respuestas, reposts, citas, vistas y guardados con los archivos multimedia, los hashtags y las menciones.
- Ordenamiento seleccionable de la línea de tiempoSolicite el ordenamiento por relevancia, más recientes o Me gusta para cada post enviado, con un límite de resultados independiente para cada conversación.
- Trazabilidad de la conversaciónConserva en el contexto normalizado la URL enviada, el ID del post padre, el ID de la conversación, el destino de la respuesta, el origen y las señales de cita, repost y respuestas limitadas.
Parámetros de la X Post Replies API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria de URL de posts públicos de x.com o twitter.com. Cada ruta debe contener /status/{numeric_id}; se aceptan las variantes de host www, m y mobile. |
results_limit | Opcional | Máximo de respuestas que se solicitan por post padre. El valor predeterminado es 100 y se aceptan múltiplos de 20 de 20 a 2000. |
sort_by | Opcional | Ordenamiento de la línea de tiempo de respuestas que se aplica a cada post enviado: relevance, latest o likes. El valor predeterminado es relevance. |
Cómo usar la X Post Replies API
Envíe URL de posts públicos conocidos como tarea asíncrona y lea los registros normalizados de respuestas de la tarea completada.
- Prepare una o más URL públicas de x.com o twitter.com que contengan un /status/{id} numérico y elija el ordenamiento por relevance, latest o likes.
- Envíe por POST urls, un results_limit por post de 20 a 2000 en incrementos de 20 y sort_by a /v1/x/post-replies.
- Guarde el task_id devuelto y consulte GET /v1/tasks/{task_id} mientras la tarea esté en queued, running o retrying.
- Tras el éxito, lea data.results.items y solicite la misma tarea con cursor=data.results.next_cursor mientras data.results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/x/post-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"],"results_limit":100,"sort_by":"relevance"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass data.results.next_cursor as cursor while has_more is trueCasos de uso de la X Post Replies API
- Análisis de la respuesta pública: Compare el texto de las respuestas, el idioma, los autores y la interacción visible entre posts padre seleccionados para examinar en qué se diferencian las conversaciones públicas.
- Reconstrucción de hilos de conversación: Use parent_post_id, conversation_id, los campos in_reply_to, los ID de las respuestas y las URL canónicas para volver a conectar las respuestas guardadas con el contexto visible de su hilo.
- Monitoreo de respuestas entre ejecuciones de recopilación: Siga las horas de publicación de las respuestas, collected_at, los autores y los contadores públicos de un conjunto estable de URL de posts mediante instantáneas programadas.
- Preparación manual de conjuntos de datos de clasificación: Combine el texto de las respuestas, la identidad de los autores, las marcas de tiempo, las URL y la interacción visible para preparar registros de respuestas destinados a colas de revisión posteriores.
Consejos de expertos para la X Post Replies API
- Valide cada URL contra un host de X o Twitter aceptado y un ID numérico de /status/ antes del envío, para que los enlaces de perfil y de búsqueda no generen tareas fallidas.
- Extraiga y deduplique el ID de estado numérico entre las variantes de URL de x.com y twitter.com, porque cadenas de URL distintas pueden apuntar al mismo post padre.
- Dimensione results_limit por post padre en incrementos de 20; el total de candidatos puede acercarse a urls × results_limit antes de considerar el final de las conversaciones y la deduplicación a nivel de tarea.
- Elija sort_by según el objetivo de la recopilación, pero no compare posiciones entre los modos relevance, latest y likes como si fueran una puntuación de clasificación compartida.
- Al reconstruir muchas conversaciones de posts padre, tenga en cuenta la deduplicación de respuestas a nivel de tarea, porque una respuesta guardada conserva el contexto de una sola URL enviada y de un solo post padre.
- Trate un resultado corto o vacío como un efecto de la visibilidad pública y almacene los campos de autor, archivos multimedia, métricas y relaciones que puedan ser nulos sin inventar valores de relleno.
APIs relacionadas
Además de la X Post Replies 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.
- Twitter User Tweets Scraper API — Recolecta posts públicos recientes, autores, contenido multimedia, hashtags, menciones e interacción por nombre de usuario, sin incluir respuestas.
- Twitter Search API — Encuentra posts públicos mediante una expresión de búsqueda, con orden por más recientes o más populares y un límite de resultados configurable.
- 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 User Replies API — Recolecta las respuestas que escribió una cuenta, cada una junto al post al que responde.
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community 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
- Twitter Follow Checker API
- Twitter Video Transcript API