Truth Social User Posts
Truth Social User Posts obtiene las publicaciones de una cuenta pública conocida. Cada tarea identifica la cuenta por nombre de usuario o por user_id numérico, realiza una sola solicitud de recopilación y devuelve registros de publicaciones coherentes.
Funcionalidades de la Truth Social User Posts API
- Dos identificadores de cuentaUse un nombre de usuario público o un user_id compuesto solo por dígitos. Se requiere al menos un identificador.
- Un lote por tareaCada tarea realiza una recopilación de publicaciones de la cuenta y devuelve las publicaciones públicas disponibles en esa respuesta, sin obtener páginas posteriores del origen.
- Contenido de publicaciones normalizadoReciba el ID de la publicación, la URL, el texto, el autor, las horas de publicación y de recopilación, el contenido multimedia, los hashtags y las menciones en campos fijos.
- Interacción visibleConserva los conteos disponibles de Me gusta, comentarios, veces compartido y vistas, y mantiene en null los valores no disponibles.
Parámetros de la Truth Social User Posts API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
username | Obligatorio (al menos uno) | Nombre de usuario público con una @ inicial opcional seguida de 1–64 letras ASCII, dígitos, puntos, guiones bajos o guiones. No se aceptan espacios iniciales ni finales ni URL de perfil. |
user_id | Obligatorio (al menos uno) | ID de cuenta compuesto solo por dígitos. Puede reemplazar a username o enviarse junto con el nombre de usuario correspondiente. |
trim | Opcional | Booleano opcional. Envíe true o false cuando necesite definir la opción de forma explícita; omita el campo cuando no quiera enviarlo. |
Cómo usar la Truth Social User Posts API
Proporcione un nombre de usuario o un user_id, guarde el ID de la tarea y lea la lista de publicaciones cuando la tarea tenga éxito.
- Ingrese un nombre de usuario público o un user_id compuesto solo por dígitos. En la mayoría de los casos, proporcione un solo identificador.
- Envíe la entrada por POST a /v1/truth-social/user-posts y guarde data.task_id de la respuesta.
- Consulte GET /v1/tasks/{task_id} hasta que la tarea tenga éxito o falle.
- Tras el éxito, lea data.results.items. Siga next_cursor solo cuando has_more sea true para los resultados almacenados.
curl -X POST "https://api.socq.ai/v1/truth-social/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"realDonaldTrump"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successCasos de uso de la Truth Social User Posts API
- Instantáneas del contenido de una cuenta: Guarde las publicaciones públicas disponibles en este momento para archivarlas, revisarlas o compararlas de forma programada.
- Análisis de contenido: Clasifique, busque y procese publicaciones con campos coherentes de texto, autor, contenido multimedia y marca de tiempo.
- Observación de la interacción: Compare los Me gusta, comentarios, veces compartido y vistas visibles junto con collected_at como hora de observación.
Consejos de expertos para la Truth Social User Posts API
- Prefiera un nombre de usuario verificado. Si el resultado de otra cuenta proporciona un author.id numérico, se puede reutilizar como user_id.
- No coloque la URL de un perfil en username ni en user_id.
- Cuando envíe ambos identificadores, asegúrese de que correspondan a la misma cuenta, porque se reenvían los dos valores.
- Este endpoint no acepta results_limit ni un cursor de origen; cada tarea recopila una sola vez.
- next_cursor solo avanza por los resultados guardados de la tarea y no recopila más publicaciones del origen.
APIs relacionadas
Además de la Truth Social User Posts API, use estas APIs cuando necesite otro tipo de datos públicos de Truth Social.
- Truth Social Post API — Convierte la URL de una publicación conocida de Truth Social en contenido normalizado, contexto del autor, contenido multimedia, marcas de tiempo y campos de interacción visible disponibles.
- Truth Social Profile API — Obtiene un perfil público de Truth Social por nombre de usuario, con identidad normalizada, biografía, contenido multimedia del perfil, indicadores de cuenta, ubicación, conteos visibles y contexto de recolección.