Truth Social APIs
Получайте публичные данные аккаунта, собирайте одну исходную страницу публикаций аккаунта или превращайте один известный URL публикации в нормализованные записи.
Доступные API Truth Social
Используйте Profile для одного имени пользователя, User Posts для имени пользователя или числового ID аккаунта и Post для одного известного URL публикации на truthsocial.com.
Какие данные Truth Social можно получить?
Результаты используют стабильные схемы аккаунтов и публикаций, а поля, зависящие от источника, могут быть null.
Идентификация профиля
Читайте доступные имя пользователя, отображаемое имя, описание профиля, медиа профиля, сайт, признаки аккаунта, местоположение и видимые счетчики.
Контент публикаций
Получайте нормализованные идентификационные данные публикации, публичный URL, текст, контекст автора, время публикации и время сбора.
Медиа и вовлеченность
Используйте доступные вложения, хештеги, упоминания и видимые счетчики лайков, комментариев, репостов и просмотров.
Выбор API Truth Social
У каждого эндпоинта ограниченный входной источник, и все они используют один и тот же процесс асинхронных задач.
| Эндпоинт | Входные данные | Охват источника |
|---|---|---|
| Profile | Одно имя пользователя | Один публичный аккаунт |
| User Posts | Имя пользователя или числовой ID пользователя | Одна страница ответа провайдера |
| Post | Один URL на truthsocial.com | Не более одной публичной публикации |
Как устроен сбор данных Truth Social
Отправка задачи и получение сохраненных результатов — отдельные этапы.
1. Выберите эндпоинт
Выберите Profile, User Posts или Post для уже известного вам публичного ресурса.
2. Отслеживайте задачу
Сохраните task_id и опрашивайте /v1/tasks/{task_id} до успешного завершения или ошибки.
3. Читайте сохраненные записи
После успешного завершения читайте data.results.items и переходите по next_cursor, только пока у сохраненных результатов есть следующая страница.
Передайте корректный публичный идентификатор и пройдите аутентификацию с API-ключом SocQ.
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"}'Типичные сценарии использования API Truth Social
Обогащение публичных аккаунтов
Добавляйте к известному публичному имени пользователя доступные идентификационные данные, описание профиля, изображения, признаки и счетчики.
Снимки публикаций аккаунта
Сохраняйте записи публикаций, доступные для выбранного аккаунта, с известным временем сбора.
Разбор известной публикации
Нормализуйте одну публичную публикацию с доступными данными автора, медиа, временными метками и видимой вовлеченностью.
Охват и границы
Эти эндпоинты читают публичные данные, доступные во время сбора, и не выполняют действий по управлению аккаунтом.
- Profile требует одно имя пользователя по шаблону с необязательным @.
- User Posts требует username или user_id только из цифр; если переданы оба значения, передаются оба, а trim — необязательный логический параметр.
- Post требует непустой URL, чей разобранный хост — truthsocial.com или его поддомен.
- Запросы не принимают results_limit и курсор провайдера.
- Курсор и лимит результатов листают записи, уже сохраненные в SocQ, а не загружают следующую страницу источника.
FAQ по API Truth Social
Какие API Truth Social доступны?
Profile получает один публичный аккаунт, User Posts собирает одну исходную страницу по имени пользователя или числовому ID аккаунта, а Post получает данные по одному известному URL публичной публикации.
Может ли User Posts принимать и username, и user_id?
Да. Нужно хотя бы одно значение, и бэкенд передает оба непустых значения, не отдавая приоритет ни одному из них.
Собирает ли next_cursor дополнительные публикации из источника?
Нет. Он только листает записи, уже сохраненные после успешного завершения задачи.
Сколько стоит сбор данных?
За каждую успешную задачу Truth Social списывается фиксированно 0,19 кредита SocQ.
Объединяйте данные разных платформ для более полной бизнес-аналитики
Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.
Google Ad Library API
Находите публичных рекламодателей, собирайте креативы компании или получайте один известный креатив из Transparency Center по URL для исследований и проверки.
Google Maps API
Находите публичные места, получайте нормализованные данные по известным URL Maps и собирайте публичные отзывы с привязанным к источнику контекстом места и автора.
Amazon API
Ищите публичные товары Amazon и собирайте нормализованные записи карточек товаров, бестселлеров, отзывов, профилей продавцов и витрин авторов с поддерживаемых маркетплейсов.
Apple App Store API
Собирайте публичные данные о приложениях Apple App Store, рейтинги категорий и отзывы по известным URL магазина в виде нормализованных записей приложений и отзывов.
SEO API
Запрашивайте органическую выдачу Google в реальном времени, сравнивайте спрос и сложность продвижения по ключевым словам, расширяйте исходные запросы, находите ключевые слова и страницы, которые обеспечивают сайту видимость в поиске, классифицируйте поисковый интент и собирайте результаты Google News, Google Images, Google Autocomplete, Bing и YouTube. Все эндпоинты используют один API-ключ SocQ, асинхронный процесс задач и нормализованный формат результатов.
Telegram API
Читайте открытые Telegram-каналы по ссылкам t.me: профили каналов с числом подписчиков, публикации с просмотрами и реакциями, отдельные публикации, комментарии из групп обсуждения, похожие каналы и поиск по всей истории.


