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 задачи и прочитайте список публикаций после успешного завершения задачи.
- Введите публичное имя пользователя или user_id только из цифр. В большинстве случаев указывайте только один идентификатор.
- Отправьте входные данные методом POST на /v1/truth-social/user-posts и сохраните data.task_id из ответа.
- Опрашивайте GET /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- После успешного завершения читайте 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 перемещается только по сохраненным результатам задачи и не собирает новые публикации из источника.
Связанные API
Помимо Truth Social User Posts API, используйте эти API, когда нужен другой тип публичных данных Truth Social.
- Truth Social Post API — Преобразуйте один известный URL публикации Truth Social в нормализованный контент, контекст автора, медиа, метки времени и доступные поля видимой вовлеченности.
- Truth Social Profile API — Получайте один публичный профиль Truth Social по имени пользователя: нормализованные данные аккаунта, описание, медиа профиля, признаки аккаунта, местоположение, видимые счетчики и контекст сбора.