x/
community-posts

Obtenga los posts públicos de enlaces de comunidades de X, con el texto, los autores y los conteos de interacción en conjunto y un límite de resultados independiente para cada comunidad.

X Community Posts API

Leer conversaciones de comunidades
Texto y autores de los posts
Un límite por comunidad
0.7 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 Community Posts

Los posts de una comunidad de X son mensajes compartidos dentro de un espacio temático, cada uno con autor, hora de publicación, texto y los archivos multimedia adjuntos. Leerlos junto con sus conteos de interacción ayuda a organizar el material de discusión y a comparar los posts individuales que forman la conversación pública de una comunidad.

Funcionalidades de la X Community Posts API

  • Leer posts de la comunidad que usted indiqueParta de un enlace de comunidad para recopilar las conversaciones públicas de ese espacio, en lugar del conjunto de posts publicados en el perfil de una persona.
  • Aplicar un tope independiente a cada comunidadCuando envía varios enlaces de comunidad, results_limit se aplica a cada uno y los posts se recopilan en orden de fecha de creación, de modo que su entrada define el tamaño de la recopilación de cada espacio de discusión.
  • Mantener juntos el mensaje y sus datos de apoyoCada registro de post contiene su texto, los datos del autor, la hora de publicación, los archivos multimedia y los conteos de interacción disponibles, lo que permite revisar el mensaje sin perder quién lo publicó ni cuándo.

Parámetros de la X Community Posts API

ParámetrosObligatorioDescripción
urlsObligatorioLista obligatoria de enlaces públicos de comunidades de X con un ID de comunidad numérico, como https://x.com/i/communities/1493446837214187523; en el Playground ponga un enlace por línea, o en el código use una lista JSON urls, y no un enlace de perfil, de búsqueda ni de un post individual.
results_limitOpcionalMáximo opcional de posts por comunidad; el valor predeterminado es 100 y se aceptan múltiplos de 20 de 20 a 2000, como 20, 40 o 100; con dos enlaces de comunidad y un límite de 20, cada comunidad puede aportar hasta 20 posts.

Cómo usar la X Community Posts API

La solicitud inicia una tarea de recopilación en segundo plano, por lo que la primera respuesta contiene un ID de tarea y no los datos finales; use ese ID para consultar el progreso y obtener los resultados.

  1. Copie los enlaces de las comunidades que quiera leer y elija un límite por comunidad, como 20 o 100; use el enlace de una comunidad y no la URL de un post individual.
  2. Antes de ejecutar el ejemplo, reemplace $SOCQ_API_KEY por su propia clave de API o defina esa variable de entorno. Envíe los datos JSON por POST a /v1/x/community-posts con el encabezado Authorization que se muestra a continuación y guarde el task_id de la respuesta.
  3. Use GET /v1/tasks/{task_id} con el ID guardado para consultar el progreso. queued significa en espera, running significa que la recopilación está en curso y retrying significa que se está realizando otro intento. Espere a succeeded antes de leer los resultados; si la tarea tiene el estado failed, lea error_message para conocer el motivo.
  4. Cuando la tarea finalice con éxito, lea data.results.items: cada elemento de esta lista describe un post de comunidad. Una lista vacía significa que la tarea terminó sin devolver registros.
  5. Si data.results.has_more es true, el valor next_cursor es el marcador de otra página de resultados guardados. Cópielo sin cambios en el parámetro cursor de GET /v1/tasks/{task_id}?cursor=... y continúe hasta que has_more sea false.
curl -X POST "https://api.socq.ai/v1/x/community-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/communities/1493446837214187523"],"results_limit":20}'

Casos de uso de la X Community Posts API

  • Preparar el material de origen de un resumen de conversaciones: Organice el texto de los posts obtenidos, los nombres de los autores, los enlaces y las horas en una lista de lectura que una persona o una herramienta de resumen independiente pueda usar para redactar un resumen de esos posts.
  • Comparar los conteos de interacción de un post entre instantáneas guardadas: Almacene los ID de los posts y los contadores devueltos junto con las horas de recopilación, y luego haga coincidir los mismos posts en recopilaciones posteriores para calcular usted mismo los cambios en los conteos disponibles.
  • Investigar la conversación que rodea a un post seleccionado: Elija un post de los resultados de la comunidad y pase su URL a X Thread Context para leer los posts anteriores y las respuestas disponibles alrededor de ese mensaje en particular.

Consejos de expertos para la X Community Posts API

  • Al planificar un lote, multiplique el número de enlaces de comunidad por results_limit para estimar la cantidad de registros solicitados y use la tarifa por post, en lugar de suponer que el límite se comparte entre todas las comunidades.
  • Al repetir una recopilación, haga coincidir los posts por su ID antes de agregarlos a su tabla guardada, porque un post puede aparecer de nuevo en una tarea posterior.
  • Al conservar resultados de varias comunidades, guarde los enlaces de comunidad enviados junto con la entrada de la tarea; el registro de post estándar no garantiza incluir un ID de comunidad que pueda reemplazar ese contexto de entrada.

Además de la X Community Posts 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 User Tweets Scraper API — Recolecta posts públicos recientes, autores, contenido multimedia, hashtags, menciones e interacción por nombre de usuario, sin incluir respuestas.
  • 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.
  • Twitter Mentions API — Recolecta posts públicos que mencionan a una cuenta indicada.
  • X Thread Context API — Lee un post junto con los mensajes anteriores de su cadena de respuestas, las respuestas públicas y los IDs de relación.
  • X List Tweets API — Lee la cronología de una lista, de lo más reciente a lo más antiguo, con los reposts marcados y su autor original.

Explorar otras plataformas

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

X Community Posts API — FAQ

X Community Posts API es una interfaz programática para leer los posts públicos de una lista de enlaces de comunidades de X. Devuelve texto, autores, archivos multimedia, marcas de tiempo y conteos de interacción en orden de fecha de creación, con un tope de resultados por comunidad.

Una comunidad agrupa los posts compartidos dentro de ese espacio de discusión, mientras que la línea de tiempo de un perfil agrupa los posts de una sola cuenta. Aquí se envían enlaces de comunidad; use X User Posts cuando el punto de partida sea el nombre de usuario de una cuenta.

No. Significa hasta 100 posts por cada enlace de comunidad. Por ejemplo, tres comunidades pueden solicitar hasta 300 posts en total, aunque la disponibilidad pública y la deduplicación pueden reducir la cantidad final de registros.

El límite debe avanzar en pasos de 20, así que use valores como 20, 40, 60 o 100. El rango permitido es de 20 a 2000 y el valor predeterminado es 100.

No. El cursor de una tarea permite leer otra página de los resultados que esa tarea ya guardó. No aumenta el tope original por comunidad ni inicia una nueva recopilación.

No. Devuelve registros de posts que usted puede leer, organizar o pasar a un proceso de resumen independiente. Un resumen o análisis terminado no forma parte de la respuesta.

Cada post devuelto cuesta 0.7 créditos, sin cargo base. Dos enlaces de comunidad con un límite de 100 estiman 140 créditos; si la tarea devuelve 30 posts en total, el cargo final es de 21 créditos.