truth-social/
user-posts

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

Truth Social User Posts API

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

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

README

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

Truth Social User Posts

Truth Social User Posts получает публикации известного публичного аккаунта. Каждая задача определяет аккаунт по имени пользователя или числовому user_id, выполняет один запрос на сбор и возвращает единообразные записи публикаций.

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

  • Два идентификатора аккаунтаИспользуйте публичное имя пользователя или user_id только из цифр. Нужен хотя бы один идентификатор.
  • Один пакет на задачуКаждая задача выполняет один сбор публикаций аккаунта и возвращает публичные публикации, доступные в этом ответе, не загружая следующие страницы источника.
  • Нормализованное содержание публикацийПолучайте ID публикации, URL, текст, автора, время публикации и сбора, медиафайлы, хештеги и упоминания в фиксированных полях.
  • Видимая вовлеченностьСохраняет доступное число лайков, комментариев, репостов и просмотров, а недоступные значения оставляет null.

Параметры Truth Social User Posts API

ПараметрыОбязательныйОписание
usernameОбязательный (хотя бы один)Публичное имя пользователя с необязательным начальным @, за которым следуют 1–64 символа: латинские буквы ASCII, цифры, точки, подчеркивания или дефисы. Пробелы в начале или в конце и URL профилей не принимаются.
user_idОбязательный (хотя бы один)ID аккаунта только из цифр. Может заменять username или передаваться вместе с соответствующим username.
trimНеобязательныйНеобязательное логическое значение. Передайте true или false, если нужно явно задать этот параметр; если отправлять его не нужно, просто не указывайте поле.

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

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

  1. Введите публичное имя пользователя или user_id только из цифр. В большинстве случаев указывайте только один идентификатор.
  2. Отправьте входные данные методом POST на /v1/truth-social/user-posts и сохраните data.task_id из ответа.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. После успешного завершения читайте data.results.items. Переходите по next_cursor, только если has_more равно true для сохраненных результатов.
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

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

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

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

  • Предпочитайте проверенное имя пользователя. Если в другом результате по аккаунту есть числовой author.id, его можно повторно использовать как user_id.
  • Не помещайте URL профиля в username или user_id.
  • Если вы передаете оба идентификатора, убедитесь, что они относятся к одному аккаунту, потому что передаются оба значения.
  • Этот эндпоинт не принимает results_limit или курсор источника; каждая задача выполняет сбор один раз.
  • next_cursor перемещается только по сохраненным результатам задачи и не собирает новые публикации из источника.

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

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

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

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

Truth Social User Posts API — FAQ

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

Нужен хотя бы один из них. В большинстве случаев используйте username, а user_id — если у вас уже есть числовой ID аккаунта.

Да, но оба значения передаются в сбор, поэтому они должны указывать на один и тот же аккаунт.

trim — необязательное логическое значение. Задавайте его, только если нужно явно выбрать true или false; в остальных случаях его можно не указывать.

Нет. Каждая задача выполняет один сбор из источника. next_cursor только листает записи, уже сохраненные для этой задачи.

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