truth-social/
post

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

Truth Social Post API

URL публикации
Данные одной публикации
0,19 кредита за задачу
0,19 кредита за запрос
Готово
Готово

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

README

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

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 задачи и прочитайте данные публикации после завершения.

  1. Используйте URL публичной публикации по умолчанию или замените его полной ссылкой на нужную публикацию Truth Social.
  2. Отправьте url методом POST на /v1/truth-social/post и сохраните data.task_id из ответа.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. После успешного завершения прочитайте нормализованную запись публикации из 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 или курсор источника и возвращает не более одной записи публикации на задачу.

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

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

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

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

Truth Social Post API — FAQ

Truth Social Post API получает нормализованные данные публикации по URL публичной публикации, включая текст, автора, медиафайлы, время публикации и данные о видимой вовлеченности.

Передайте полный URL публичной публикации с http или https. Имя хоста должно быть truthsocial.com или одним из его поддоменов.

Не рекомендуется. Этот эндпоинт находит конкретную публикацию, поэтому используйте реальный путь к публикации. Другая страница того же домена может пройти проверку имени хоста, но не вернуть результата.

Не более одной. Каждая задача находит публикацию, на которую указывает переданный URL.

Данные об авторе, медиафайлы, хештеги, упоминания или счетчики вовлеченности могут быть непубличными или отсутствовать в ответе источника.

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