truth-social/
profile

Укажите одно публичное имя пользователя Truth Social и получите нормализованные данные об аккаунте, описание профиля, изображения профиля, статус аккаунта и видимые метрики.

Truth Social Profile API

Поиск по имени пользователя
Профиль аккаунта
0,19 кредита за задачу
0,19 кредита за запрос
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Truth Social Profile

Truth Social Profile находит известный публичный аккаунт. Передайте имя пользователя, чтобы получить одну нормализованную запись аккаунта, которую можно сразу использовать для обогащения данных, проверки и плановых снимков профиля.

Возможности Truth Social Profile API

  • Поиск по точному имени пользователяЗапрашивайте одно известное публичное имя пользователя в каждой задаче, без нечеткого поиска аккаунтов и URL профилей.
  • Единообразные данные аккаунтаПолучайте ID аккаунта, имя пользователя, отображаемое имя, публичный URL профиля, описание профиля и время сбора в фиксированных полях.
  • Сведения профиляПолучайте аватар, обложку, сайт, местоположение, статус верификации и статус приватности, если они публично доступны.
  • Снимок видимых метрикФиксирует число подписчиков, подписок и публикаций на момент сбора для последующего сравнения.

Параметры Truth Social Profile API

ПараметрыОбязательныйОписание
usernameОбязательныйОбязательное публичное имя пользователя из 1–64 символов: латинские буквы ASCII, цифры, точки, подчеркивания или дефисы. Проверка допускает один начальный @, но рекомендуется каноническое имя пользователя без @. URL профилей не принимаются.

Как использовать Truth Social Profile API

Передайте одно публичное имя пользователя, сохраните ID задачи и прочитайте результат по аккаунту после завершения.

  1. Введите известное имя пользователя Truth Social, например realDonaldTrump. Для надежного поиска указывайте имя без начального @.
  2. Отправьте username методом POST на /v1/truth-social/profile и сохраните data.task_id из ответа.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока data.status не станет succeeded или failed.
  4. После успешного завершения прочитайте нормализованную запись аккаунта из 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 success

Сценарии использования Truth Social Profile API

  • Обогащение данных аккаунтов: Добавляйте публичные данные об аккаунте, описание профиля, изображения профиля, сайт и видимые метрики к записи, в которой уже есть имя пользователя.
  • Проверка аккаунтов: Превращайте публичные профили в единообразные поля для внутренней проверки, классификации и ручного просмотра.
  • Отслеживание изменений профиля: Сохраняйте плановые снимки и сравнивайте описание профиля, изображения, статус и метрики по collected_at.

Практические советы по Truth Social Profile API

  • Храните каноническое имя пользователя без @, чтобы у одного аккаунта не было нескольких вариантов записи.
  • Корректный синтаксис не гарантирует, что аккаунт существует, является публичным или доступен в данный момент.
  • Обрабатывайте изображения профиля, сайт, местоположение, статус и метрики как поля источника, которые могут быть null.
  • Этот эндпоинт возвращает только данные аккаунта. Для публичных публикаций используйте Truth Social User Posts API.
  • Не передавайте results_limit или курсор источника; каждая задача выполняет один поиск аккаунта.

Помимо Truth Social Profile API, используйте эти API, когда нужен другой тип публичных данных Truth Social.

  • Truth Social Post API — Преобразуйте один известный URL публикации Truth Social в нормализованный контент, контекст автора, медиа, метки времени и доступные поля видимой вовлеченности.
  • Truth Social User Posts API — Собирайте одну страницу публичных публикаций Truth Social по имени пользователя или числовому ID аккаунта: нормализованный контент, авторы, медиа, метки времени и видимая вовлеченность.

Другие платформы

Объединяйте данные Truth Social с публичными данными других поддерживаемых соцсетей.

Truth Social Profile API — FAQ

Truth Social Profile API получает нормализованную запись публичного аккаунта по имени пользователя, включая данные об аккаунте, описание профиля, изображения профиля, статус аккаунта и видимые метрики.

Используйте публичное имя пользователя без @, например realDonaldTrump. Оно может содержать латинские буквы ASCII, цифры, точки, подчеркивания и дефисы, максимальная длина — 64 символа.

Результаты могут включать ID аккаунта, имя пользователя, отображаемое имя, URL профиля, описание профиля, аватар, обложку, сайт, местоположение, статус верификации и приватности, а также число подписчиков, подписок и публикаций.

Проверка подтверждает только формат имени пользователя. Аккаунт может не существовать, быть приватным или быть публично недоступным на момент сбора.

Нет. Он возвращает только данные профиля. Для получения публичных публикаций используйте Truth Social User Posts API.

Каждая успешная задача стоит фиксированные 0,19 кредита. Для неудачных задач действует политика возврата.