Truth Social Profile
Truth Social Profile consulta una cuenta pública conocida. Envíe un nombre de usuario para recibir un registro de cuenta normalizado que se puede usar directamente para enriquecer, revisar y tomar instantáneas programadas del perfil.
Funcionalidades de la Truth Social Profile API
- Búsqueda exacta por nombre de usuarioConsulte un nombre de usuario público conocido por tarea, sin búsqueda aproximada de cuentas ni URL de perfil.
- Identidad de cuenta coherenteReciba el ID de la cuenta, el nombre de usuario, el nombre visible, la URL pública del perfil, la biografía y la hora de recopilación en campos fijos.
- Detalles del perfilObtenga el avatar, la imagen de portada, el sitio web, la ubicación, el estado de verificación y el estado de privacidad cuando son de acceso público.
- Instantánea de métricas visiblesRegistre los conteos de seguidores, seguidos y publicaciones observados en el momento de la recopilación para compararlos más adelante.
Parámetros de la Truth Social Profile API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
username | Obligatorio | Nombre de usuario público obligatorio, con 1–64 letras ASCII, dígitos, puntos, guiones bajos o guiones. La validación permite una @ inicial, pero se recomienda el nombre de usuario canónico sin @. No se aceptan URL de perfil. |
Cómo usar la Truth Social Profile API
Envíe un nombre de usuario público, guarde el ID de la tarea y lea el resultado de la cuenta al finalizar.
- Ingrese un nombre de usuario conocido de Truth Social, como realDonaldTrump. Para una resolución confiable, use el nombre de usuario sin la @ inicial.
- Envíe username por POST a /v1/truth-social/profile y guarde data.task_id de la respuesta.
- Consulte GET /v1/tasks/{task_id} hasta que data.status pase a succeeded o failed.
- Tras el éxito, lea el registro de cuenta normalizado en data.results.items.
curl -X POST "https://api.socq.ai/v1/truth-social/profile" \
-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 Profile API
- Enriquecimiento de cuentas: Agregue la identidad pública, la biografía, las imágenes de perfil, el sitio web y las métricas visibles a un registro que ya tiene un nombre de usuario.
- Revisión de cuentas: Convierta perfiles públicos en campos coherentes para la revisión interna, la clasificación y la inspección manual.
- Seguimiento de cambios en el perfil: Guarde instantáneas programadas y compare la biografía, las imágenes, el estado y las métricas con collected_at.
Consejos de expertos para la Truth Social Profile API
- Almacene el nombre de usuario canónico sin @ para evitar varias formas de la misma cuenta.
- Una sintaxis válida no garantiza que la cuenta exista, sea pública o esté accesible en este momento.
- Trate las imágenes de perfil, el sitio web, la ubicación, el estado y las métricas como campos de origen anulables.
- Este endpoint devuelve únicamente los detalles de la cuenta. Use Truth Social User Posts API para las publicaciones públicas.
- No envíe results_limit ni un cursor de origen; cada tarea realiza una sola consulta de cuenta.
APIs relacionadas
Además de la Truth Social Profile 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 User Posts API — Recolecta una página de origen de publicaciones públicas de Truth Social por nombre de usuario o ID numérico de cuenta, con contenido normalizado, autores, contenido multimedia, marcas de tiempo e interacción visible.