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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista 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.
- Abra la página pública de la comunidad y copie su enlace /i/communities/; prepare un enlace por cada comunidad que quiera consultar.
- 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.
- 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.
- 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.
- 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.
APIs relacionadas
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.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search 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 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