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á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. |
results_limit | Opcional | Má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.
- 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.
- 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.
- 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 un post de 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-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.
APIs relacionadas
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.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Account Location API
- X Verified Followers 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
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API