Recopile las discusiones de las comunidades de Twitter/X con SocQ y conserve juntos el texto de las publicaciones, los autores, las horas de publicación y las fuentes. Convierta las preguntas recurrentes en ideas de temas, con las publicaciones originales adjuntas a cada hallazgo para revisarlas más adelante.
Este tutorial usa X Community Posts de SocQ para recopilar publicaciones y X Community para consultar la descripción y las reglas. Los ejemplos generan un JSON que conserva la fuente y una exportación CSV basada en la comunidad.
Respuesta rápida: envíe enlaces
x.com/i/communities/{id}aPOST /v1/x/community-posts, guarde el ID de tarea y lea todas las páginas de resultados cuando termine con éxito. Consulte los metadatos mediantePOST /v1/x/communitycon el mismo enlace. Adjunte la comunidad de entrada a cada publicación para relacionar los metadatos con las discusiones.
Usar la URL de una comunidad pública como entrada
Use una URL con este formato y reemplácela por la comunidad pública que quiera investigar:
https://x.com/i/communities/1493446837214187523
El segmento numérico es el ID de la comunidad. Ambos endpoints de comunidades reciben una URL completa con el formato /i/communities/{numeric_id}.
Si solo conoce el nombre de la comunidad, busque primero su URL pública y envíe el enlace en urls.
Guarde la URL enviada, el ID numérico de la comunidad, la hora de publicación (published_at) y la hora de recopilación (collected_at). Relacione las variantes x.com y twitter.com compatibles por el ID de la comunidad, y mantenga separadas las comunidades con ID distintos aunque sus nombres coincidan.
Recopilar publicaciones del feed de una comunidad de Twitter/X
Defina SOCQ_API_KEY y envíe una tarea limitada a 40 publicaciones por comunidad:
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": 40
}'
La respuesta incluye data.task_id. Guárdelo y luego consulte la tarea existente:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Espere entre solicitudes mientras la tarea esté en queued, running o retrying. Una tarea failed expone data.error_message. Cuando está en succeeded, los registros de las publicaciones se encuentran en data.results.items.
Community Posts devuelve los registros ordenados por hora de creación. Para un reporte ordenado por Me gusta o comentarios, ordene localmente los registros recopilados y etiquete el resultado como una clasificación de muestra.
Los límites por comunidad
results_limit tiene un valor predeterminado de 100 y acepta múltiplos de 20 entre 20 y 2000, como 20, 40, 60 y 100.
El tope se aplica a cada comunidad de entrada. Dos URL con results_limit=40 solicitan hasta 40 publicaciones cada una; la cantidad real la determinan los resultados guardados sin duplicados.
El limit de la consulta de la tarea define cuántos registros guardados se leen por página, y next_cursor identifica la página siguiente. El results_limit enviado define el tope de recopilación.
Qué datos de la comunidad se obtienen
| Recurso | Campos estándar | Pregunta de investigación |
|---|---|---|
| Community | name, text, rules, join_policy, invites_policy | ¿Qué descripción, reglas y políticas de participación se registraron? |
| Conteos de la comunidad | metrics.members_count, metrics.moderators_count | ¿Cuántos miembros y moderadores informa la fuente? |
| Community Posts | id, text, author, published_at, media | ¿Qué discusiones hay en la ventana recopilada? |
| Métricas de las publicaciones | Conteos disponibles de Me gusta, comentarios, veces compartido y vistas | ¿Cómo se comparan las publicaciones de la muestra en el momento de la recopilación? |
La solicitud de metadatos es independiente:
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"]}'
Obtenga los metadatos mediante su propio ID de tarea. Los totales de miembros y moderadores describen la escala de la comunidad, mientras que el conteo de vistas de una publicación registra las vistas de esa publicación. El número de autores activos y el alcance único requieren sus propias mediciones.
Null significa que la fuente omitió una medición; 0 es un conteo devuelto de cero. Conserve ambos valores por separado en su exportación.
Exportar publicaciones de comunidades a JSON y CSV con Python
El siguiente flujo usa la biblioteca estándar de Python. Guarde este asistente de tareas como socq_collect.py:
import json
import os
import time
from urllib.parse import urlencode
from urllib.request import Request, urlopen
BASE = "https://api.socq.ai/v1"
PENDING = {"queued", "running", "retrying"}
def api(method, path, payload=None):
body = json.dumps(payload).encode("utf-8") if payload is not None else None
request = Request(
BASE + path, data=body, method=method,
headers={
"Authorization": "Bearer " + os.environ["SOCQ_API_KEY"],
"Content-Type": "application/json",
},
)
with urlopen(request, timeout=60) as response:
result = json.load(response)
if result.get("code") != 200:
raise RuntimeError(result)
return result["data"]
def collect(endpoint, payload):
task_id = api("POST", "/" + endpoint, payload)["task_id"]
print("Task:", task_id, flush=True)
path = "/tasks/" + task_id
deadline = time.monotonic() + 600
data = api("GET", path + "?limit=100")
while data["status"] in PENDING:
if time.monotonic() >= deadline:
raise TimeoutError("Resume GET " + path + "; do not resubmit automatically")
time.sleep(2)
data = api("GET", path + "?limit=100")
if data["status"] != "succeeded":
raise RuntimeError(data.get("error_message") or data["status"])
items, seen_cursors = [], set()
while True:
if time.monotonic() >= deadline:
raise TimeoutError("Resume pagination for " + task_id)
page = data["results"]
items.extend(page["items"])
if not page["has_more"]:
return task_id, items
cursor = page.get("next_cursor")
if not cursor or cursor in seen_cursors:
raise RuntimeError("Missing or repeated result cursor")
seen_cursors.add(cursor)
data = api("GET", path + "?" + urlencode({"limit": 100, "cursor": cursor}))
if data["status"] != "succeeded":
raise RuntimeError("Task is not ready for result pagination")
El asistente imprime cada ID de tarea, espera hasta diez minutos y lee todas las páginas de resultados guardadas. Después de un tiempo de espera agotado del cliente, conserve el ID y reanude la consulta de esa tarea.
A continuación, guarde export_communities.py junto al anterior:
import csv
import json
import sys
from urllib.parse import urlparse
from socq_collect import collect
urls = list(dict.fromkeys(sys.argv[1:]))
if not urls:
raise SystemExit("Usage: python3 export_communities.py COMMUNITY_URL [COMMUNITY_URL...]")
def cell(value):
text = "" if value is None else str(value)
return "'" + text if text.lstrip().startswith(("=", "+", "-", "@")) else text
fields = ["community_id", "community_url", "post_id", "post_url", "text",
"author_id", "author_username", "published_at", "collected_at",
"likes_count", "comments_count", "shares_count", "views_count"]
bundles, seen = [], set()
with open("community-posts.csv", "w", newline="", encoding="utf-8-sig") as output:
writer = csv.DictWriter(output, fieldnames=fields)
writer.writeheader()
for url in urls:
metadata_task, communities = collect("x/community", {"urls": [url]})
posts_task, posts = collect("x/community-posts", {
"urls": [url], "results_limit": 40,
})
bundles.append({
"input_url": url, "metadata_task_id": metadata_task,
"posts_task_id": posts_task, "communities": communities, "posts": posts,
})
# Save completed collections before processing another community.
with open("community-results.json", "w", encoding="utf-8") as saved:
json.dump(bundles, saved, ensure_ascii=False, indent=2)
community_id = urlparse(url).path.rstrip("/").split("/")[-1]
for post in posts:
post_id = post.get("id")
key = (community_id, post_id)
if post_id and key in seen:
continue
if post_id:
seen.add(key)
author = post.get("author") or {}
metrics = post.get("metrics") or {}
row = {
"community_id": community_id, "community_url": url,
"post_id": post_id, "post_url": post.get("url"), "text": post.get("text"),
"author_id": author.get("id"), "author_username": author.get("username"),
"published_at": post.get("published_at"),
"collected_at": post.get("collected_at"),
**{name: metrics.get(name) for name in
("likes_count", "comments_count", "shares_count", "views_count")},
}
writer.writerow({key: cell(value) for key, value in row.items()})
Ejecútelo con una o más URL de comunidades públicas:
python3 export_communities.py \
"https://x.com/i/communities/1493446837214187523"
Se obtienen dos salidas:
community-results.jsonconserva cada URL de entrada, ambos ID de tarea, los metadatos de la comunidad y los registros de las publicaciones.community-posts.csvofrece una fila por cada publicación devuelta dentro de cada comunidad, con la fuente, el autor, las marcas de tiempo y las métricas disponibles.
El ejemplo crea tareas separadas de metadatos y de publicaciones para cada comunidad, y adjunta la comunidad de entrada a sus publicaciones. Así, la fuente de recopilación de cada registro queda explícita. Use un lote para una recuperación combinada, o el patrón de tarea por comunidad individual que se muestra aquí cuando necesite la atribución de la fuente por publicación.
La eliminación de duplicados usa community_id + post_id. Fusiona las filas repetidas dentro de una comunidad y mantiene separadas las observaciones de la misma publicación provenientes de comunidades distintas. Los registros sin ID de publicación se conservan de forma individual.
El programa actualiza los archivos después de completar cada comunidad. Si una solicitud posterior falla, los archivos conservan las comunidades completadas anteriormente. Antes de usar la salida en un reporte, revise las entradas completadas y los errores registrados.
Conservar el JSON como fuente de las exportaciones a hojas de cálculo
El CSV es práctico para quienes revisan, pero aplana los datos. Las reglas anidadas, los medios y los campos del autor siguen disponibles en el JSON. Regenere otra hoja de cálculo a partir de ese JSON guardado cuando cambien sus columnas.
El ejemplo usa el escritor CSV de la biblioteca estándar de Python para manejar comillas, comas y texto de varias líneas. UTF-8 con marca de orden de bytes ayuda en las importaciones habituales a hojas de cálculo. El texto público con forma de fórmula se escapa en el CSV; el JSON conserva el contenido original. Importe los ID numéricos largos como texto para evitar la pérdida de precisión en la hoja de cálculo.
Usar las discusiones de la comunidad para investigar temas
Por ejemplo, pregunte qué dudas de incorporación se repiten en estas discusiones recopiladas. Agrúpelas por pregunta y conserve los ID de las publicaciones de respaldo de cada categoría.
Lea primero la descripción y las reglas de la comunidad. Luego revise juntos el texto de las publicaciones, la hora de publicación y los enlaces de origen. Agrupe las preguntas recurrentes, las quejas sobre productos o las solicitudes de recursos, y mantenga los ID de las publicaciones de respaldo junto a sus etiquetas.
Use el flujo de detalles de la comunidad para guardar descripciones y reglas, y luego ejecute la clasificación o el resumen de temas en su aplicación.
Etiquete un orden local por Me gusta o comentarios como una “clasificación dentro de esta captura”, con su hora de recopilación y su cantidad de registros. Marque una publicación ausente en una captura posterior como “no observada en esta captura”; consulte esa publicación por separado para investigar si fue eliminada.
Examinar una discusión individual
Para ampliar una discusión, envíe la URL de la publicación devuelta a X Thread Context y lea el objetivo, las publicaciones anteriores de la cadena de respuestas y las relaciones entre respuestas.
Para ese paso siguiente, lea el tutorial de contexto de hilos de Twitter. Si solo necesita las respuestas a una publicación conocida, use X Post Replies. Si su punto de partida es una cuenta y no una comunidad, use X User Posts.
Mantener las publicaciones originales detrás de sus decisiones de contenido
Los endpoints de metadatos y de publicaciones de comunidades de SocQ conectan la identificación de la comunidad, la recopilación de discusiones y la revisión de temas. El código conserva la comunidad de origen de cada publicación y exporta JSON y CSV, de modo que los equipos de contenido puedan revisar preguntas, organizar ejemplos y preparar insumos para resúmenes.
Abra Community Posts y recopile su comunidad objetivo.
Fuentes y lecturas adicionales
- Documentación de SocQ Community Posts – enlaces aceptados, límites por comunidad y campos estándar de las publicaciones.
- Documentación de SocQ Community – metadatos, reglas y conteos.
Community Posts: preguntas frecuentes (FAQ)
¿Puedo recopilar publicaciones de varias comunidades de X?
Sí. Envíe varias URL de comunidades en urls. El tope de resultados se aplica a cada URL. El ejemplo de exportación en Python usa tareas separadas para conservar una fuente clara de la comunidad de entrada de cada publicación.
¿Esto devuelve todas las publicaciones que se hayan hecho en una comunidad?
Una tarea lee una selección de publicaciones de la comunidad especificada, limitada por results_limit. Los registros devueltos definen el alcance de esa captura. Para un análisis histórico, guarde capturas separadas e informe el alcance de cada una.
¿Puedo exportar los miembros de la comunidad además de las publicaciones?
Community devuelve metadatos y los conteos de miembros y moderadores; Community Posts devuelve publicaciones. Los directorios de miembros individuales son datos distintos y estos endpoints no los devuelven.
¿En qué se diferencia el feed de una comunidad de la cronología de un usuario?
El feed de una comunidad agrupa las publicaciones de un espacio de discusión; la cronología de un usuario agrupa las publicaciones de una cuenta. Use enlaces de comunidades para Community Posts y nombres de usuario para User Posts.
¿Puedo elegir el orden Top o por Me gusta?
El endpoint devuelve los registros ordenados por hora de creación. Ordene la muestra por Me gusta o comentarios en su aplicación para obtener una clasificación por métrica de esa captura.
¿La paginación recopila publicaciones nuevas?
El cursor lee la página siguiente guardada por la tarea original. Envíe una tarea nueva para obtener una observación reciente y luego maneje los registros superpuestos por ID de publicación.
¿Cómo recopilo publicaciones después del anuncio de migración de las comunidades?
X publicó un anuncio de migración de Communities a XChat. Envíe la URL de la comunidad objetivo a Community Posts y lea las publicaciones devueltas cuando termine con éxito. Registre por separado los resultados vacíos y las fallas, y conserve las horas de recopilación para distinguir el historial guardado de cada consulta nueva.
X API
Probar el flujo de trabajo con una URL pública de X
Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.
Ver las API de X