truth-social/
user-posts

Ingrese un nombre de usuario público o un user_id numérico para obtener las publicaciones disponibles de una cuenta, con texto, autor, contenido multimedia, fechas y datos de interacción normalizados.

Truth Social User Posts API

Nombre de usuario o user_id
Publicaciones públicas de la cuenta
0.19 créditos por tarea
0.19 créditos por solicitud
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

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ámetrosObligatorioDescripción
usernameObligatorio (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_idObligatorio (al menos uno)ID de cuenta compuesto solo por dígitos. Puede reemplazar a username o enviarse junto con el nombre de usuario correspondiente.
trimOpcionalBooleano 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.

  1. 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.
  2. Envíe la entrada por POST a /v1/truth-social/user-posts y guarde data.task_id de la respuesta.
  3. Consulte GET /v1/tasks/{task_id} hasta que la tarea tenga éxito o falle.
  4. 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 success

Casos 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.

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.

Explorar otras plataformas

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

Truth Social User Posts API — FAQ

Truth Social User Posts API obtiene las publicaciones públicas de una cuenta por nombre de usuario o user_id numérico y devuelve texto, autor, contenido multimedia, fechas y datos de interacción visible normalizados.

Se requiere al menos uno. Use username en la mayoría de los casos, o user_id cuando ya tenga el ID numérico de la cuenta.

Sí, pero ambos valores se reenvían a la recopilación, por lo que deben identificar la misma cuenta.

trim es un booleano opcional. Defínalo solo cuando necesite elegir de forma explícita true o false; en otro caso se puede omitir.

No. Cada tarea realiza una sola recopilación del origen. next_cursor solo pagina los registros ya guardados para esa tarea.

Cada tarea exitosa cuesta una tarifa fija de 0.19 créditos, sin importar la cantidad de publicaciones devueltas.