Truth Social Post
Truth Social Post находит одну известную публичную публикацию. Передайте URL публикации, чтобы получить не более одной нормализованной записи для обогащения ссылок, проверки контента и плановых снимков вовлеченности.
Возможности Truth Social Post API
- Поиск по точному URLПередавайте один URL публичной публикации на truthsocial.com в каждой задаче, без поиска по ключевым словам.
- Полное содержание публикацииПолучайте ID публикации, публичный URL, текст, время публикации и время сбора.
- Контекст автора и медиаСохраняет доступные данные об авторе, аватар, статус аккаунта, медиафайлы, хештеги и упоминания.
- Снимок вовлеченностиФиксирует видимое число лайков, комментариев, репостов и просмотров, а недоступные значения оставляет null.
Параметры Truth Social Post API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный | Обязательный полный URL публичной публикации Truth Social. Разобранное имя хоста должно быть truthsocial.com или его поддоменом. Укажите http или https и передайте реальный путь к публикации. |
Как использовать Truth Social Post API
Передайте URL реальной публичной публикации, сохраните ID задачи и прочитайте данные публикации после завершения.
- Используйте URL публичной публикации по умолчанию или замените его полной ссылкой на нужную публикацию Truth Social.
- Отправьте url методом POST на /v1/truth-social/post и сохраните data.task_id из ответа.
- Опрашивайте GET /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- После успешного завершения прочитайте нормализованную запись публикации из data.results.items.
curl -X POST "https://api.socq.ai/v1/truth-social/post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://truthsocial.com/@realDonaldTrump/117091934703272898"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successСценарии использования Truth Social Post API
- Обогащение ссылок на публикации: Превращайте известную ссылку на публикацию в текст, автора, метку времени и поля источника, по которым можно искать.
- Проверка выбранного контента: Получайте текст, автора и вложения конкретной публичной публикации в рамках процесса проверки.
- Отслеживание изменений вовлеченности: Повторяйте запрос по расписанию и сравнивайте публичную вовлеченность вместе с collected_at.
Практические советы по Truth Social Post API
- Передавайте полный URL реальной публикации, а не профиля, страницы поиска или другой страницы Truth Social.
- URL должен содержать http или https и вести на truthsocial.com или один из его поддоменов.
- Успешная проверка URL не гарантирует, что публикация существует или остается публично доступной.
- Обрабатывайте данные об авторе, медиафайлы, хештеги, упоминания и данные вовлеченности как поля, которые могут быть null.
- Этот эндпоинт не принимает results_limit или курсор источника и возвращает не более одной записи публикации на задачу.
Связанные API
Помимо Truth Social Post API, используйте эти API, когда нужен другой тип публичных данных Truth Social.
- Truth Social Profile API — Получайте один публичный профиль Truth Social по имени пользователя: нормализованные данные аккаунта, описание, медиа профиля, признаки аккаунта, местоположение, видимые счетчики и контекст сбора.
- Truth Social User Posts API — Собирайте одну страницу публичных публикаций Truth Social по имени пользователя или числовому ID аккаунта: нормализованный контент, авторы, медиа, метки времени и видимая вовлеченность.