x/
community

Lea los detalles públicos de comunidades de X a partir de sus enlaces, con descripciones, conteos de miembros y reglas, y con soporte para consultar varias comunidades a la vez.

X Community API

Detalles de la comunidad
Conteos de miembros y moderadores
Reglas y políticas de ingreso
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 Community

Una comunidad de X es un espacio de discusión temático con nombre, descripción, conteos de miembros y reglas de participación. Estos datos ayudan a entender el tema de la comunidad, comparar su tamaño con el de otras y revisar sus políticas de participación antes de explorar las conversaciones.

Funcionalidades de la X Community API

  • Entender de qué trata una comunidadObtenga juntos el nombre de la comunidad, su descripción pública, el enlace, la imagen de portada y los datos del creador, para identificar el espacio y leer su tema declarado antes de buscar posts.
  • Conocer su tamaño y sus políticas de participaciónReciba los conteos de miembros y moderadores junto con join_policy e invites_policy, que describen cómo se gestionan el ingreso y las invitaciones de miembros.
  • Leer las reglas propias de la comunidadLa lista de reglas incluye los nombres y las descripciones de cada regla, de modo que los requisitos de participación quedan junto a la información básica de la comunidad.

Parámetros de la X Community 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.

Cómo usar la X Community 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. Abra la página pública de la comunidad y copie su enlace /i/communities/; prepare un enlace por cada comunidad que quiera consultar.
  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 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 los detalles de una 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" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/communities/1493446837214187523"]}'

Casos de uso de la X Community API

  • Crear un directorio de comunidades para explorar: Reúna en una tabla los nombres, las descripciones, los enlaces y los conteos de miembros de las comunidades para que una persona las compare por tema y tamaño antes de decidir qué conversaciones leer.
  • Conservar las reglas de participación junto con la revisión de una conversación: Guarde las reglas y las políticas de membresía bajo el ID de la comunidad y use después X Community Posts por separado para asociar los posts que quiera revisar con el contexto de esa comunidad.

Consejos de expertos para la X Community API

  • Si parte de un post y no de la página de una comunidad, busque primero el enlace público de la comunidad, porque esta consulta no determina la comunidad de un post a partir de la URL del post.
  • Cuando la misma comunidad aparezca en enlaces de x.com y de twitter.com, use el ID numérico que sigue a /i/communities/ como clave de coincidencia para no crear entradas duplicadas en el directorio.
  • Al comparar comunidades, use los conteos de miembros como medida de tamaño y no como evidencia de la actividad de publicación; este resultado no contiene historial de actividad ni la lista de miembros individuales.

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

  • 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 Community Posts API — Lee los posts públicos compartidos en una comunidad, con su texto, autores y conteos de interacción.
  • X Community Members API — Exporta los miembros de una comunidad como perfiles completos con biografía y número de seguidores.
  • X Community Moderators API — Obtén los administradores y moderadores de una comunidad como perfiles completos.

Explorar otras plataformas

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

X Community API — FAQ

X Community API es una interfaz programática que recupera información pública de comunidades de X a partir de una lista de enlaces. Devuelve nombres, descripciones, conteos de miembros y moderadores, reglas y políticas de ingreso para entender cada comunidad antes de explorar sus posts.

Un enlace de comunidad contiene /i/communities/ seguido de un ID numérico. Un enlace de perfil apunta a una cuenta y un enlace con /status/ apunta a un post, por lo que ninguno sirve como entrada de esta consulta.

No. Un conteo indica cuántos miembros tiene la comunidad, no quiénes son; la respuesta no contiene un directorio de miembros.

No. Esta consulta devuelve la descripción, las reglas y otros metadatos de la comunidad. Use el mismo enlace de comunidad con X Community Posts cuando necesite las conversaciones en sí.

No. Las comunidades de X son espacios organizados en torno a temas de conversación compartidos. Community Notes son anotaciones sobre posts, y esas anotaciones no son el objeto que se devuelve aquí.

Cada registro de comunidad devuelto cuesta 0.5 créditos, sin cargo base. Por ejemplo, cuatro enlaces de comunidad enviados estiman 2 créditos, y cuatro registros de comunidad devueltos cuestan 2 créditos.