x/
post-replies

Recopile las respuestas públicas de una o más URL de posts de X, con el texto de la respuesta, los autores, la interacción visible, los archivos multimedia y el contexto del post padre, con límites por post y ordenamiento.

X Post Replies API

Conversaciones de posts
Ordenamiento de respuestas
Contexto del post padre
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 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ámetrosObligatorioDescripción
urlsObligatorioLista 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_limitOpcionalMá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_byOpcionalOrdenamiento 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.

  1. 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.
  2. 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.
  3. Guarde el task_id devuelto y consulte GET /v1/tasks/{task_id} mientras la tarea esté en queued, running o retrying.
  4. 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 true

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

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.

Explorar otras plataformas

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

X Post Replies API — FAQ

X Post Replies API es una interfaz programática para recopilar las respuestas públicas de una o más URL de posts de X que contienen ID de estado numéricos. Devuelve el texto de las respuestas, los autores, la interacción visible, los archivos multimedia, las marcas de tiempo y el contexto de la conversación padre.

Envíe una lista urls que no esté vacía con enlaces de posts públicos de x.com o twitter.com que tengan /status/{numeric_id} en la ruta. Se aceptan las variantes de host estándar, www, m y mobile.

results_limit tiene un valor predeterminado de 100, acepta múltiplos de 20 de 20 a 2000 y se aplica por separado a cada post padre. Una conversación puede terminar antes del límite solicitado.

sort_by selecciona el modo correspondiente de la línea de tiempo pública de respuestas para cada post enviado, y relevance es el valor predeterminado. Trate el orden devuelto como el modo de recopilación elegido y no como una puntuación de clasificación propia de SocQ.

Una respuesta puede incluir su ID, URL, texto, idioma, autor público, conteos visibles, archivos multimedia, hashtags, menciones, horas de publicación y de recopilación, además de los campos de conversación y de post padre en extra.

El post padre enviado se excluye de sus resultados de respuestas. Los ID de las respuestas se deduplican durante la recopilación y de nuevo al guardar los resultados de la tarea, por lo que las apariciones repetidas pueden reducirse a un solo registro.

Las ramas de respuestas ocultas, eliminadas, protegidas, limitadas, no disponibles o desconectadas pueden no ser visibles públicamente. La recopilación también se detiene cuando termina la conversación visible o se alcanza el límite solicitado por post.

No. Devuelve los posts de respuesta de las conversaciones seleccionadas; los posts de cita y los perfiles que hicieron repost de un post son recursos de X independientes.

Cada respuesta normalizada guardada cuesta 0.5 créditos. La facturación usa la cantidad real de registros guardados, por lo que un resultado vacío no tiene cargo por unidad de resultado.