Truth Social Profile
Truth Social Profile находит известный публичный аккаунт. Передайте имя пользователя, чтобы получить одну нормализованную запись аккаунта, которую можно сразу использовать для обогащения данных, проверки и плановых снимков профиля.
Возможности Truth Social Profile API
- Поиск по точному имени пользователяЗапрашивайте одно известное публичное имя пользователя в каждой задаче, без нечеткого поиска аккаунтов и URL профилей.
- Единообразные данные аккаунтаПолучайте ID аккаунта, имя пользователя, отображаемое имя, публичный URL профиля, описание профиля и время сбора в фиксированных полях.
- Сведения профиляПолучайте аватар, обложку, сайт, местоположение, статус верификации и статус приватности, если они публично доступны.
- Снимок видимых метрикФиксирует число подписчиков, подписок и публикаций на момент сбора для последующего сравнения.
Параметры Truth Social Profile API
| Параметры | Обязательный | Описание |
|---|---|---|
username | Обязательный | Обязательное публичное имя пользователя из 1–64 символов: латинские буквы ASCII, цифры, точки, подчеркивания или дефисы. Проверка допускает один начальный @, но рекомендуется каноническое имя пользователя без @. URL профилей не принимаются. |
Как использовать Truth Social Profile API
Передайте одно публичное имя пользователя, сохраните ID задачи и прочитайте результат по аккаунту после завершения.
- Введите известное имя пользователя Truth Social, например realDonaldTrump. Для надежного поиска указывайте имя без начального @.
- Отправьте username методом POST на /v1/truth-social/profile и сохраните data.task_id из ответа.
- Опрашивайте GET /v1/tasks/{task_id}, пока data.status не станет succeeded или failed.
- После успешного завершения прочитайте нормализованную запись аккаунта из data.results.items.
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"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successСценарии использования Truth Social Profile API
- Обогащение данных аккаунтов: Добавляйте публичные данные об аккаунте, описание профиля, изображения профиля, сайт и видимые метрики к записи, в которой уже есть имя пользователя.
- Проверка аккаунтов: Превращайте публичные профили в единообразные поля для внутренней проверки, классификации и ручного просмотра.
- Отслеживание изменений профиля: Сохраняйте плановые снимки и сравнивайте описание профиля, изображения, статус и метрики по collected_at.
Практические советы по Truth Social Profile API
- Храните каноническое имя пользователя без @, чтобы у одного аккаунта не было нескольких вариантов записи.
- Корректный синтаксис не гарантирует, что аккаунт существует, является публичным или доступен в данный момент.
- Обрабатывайте изображения профиля, сайт, местоположение, статус и метрики как поля источника, которые могут быть null.
- Этот эндпоинт возвращает только данные аккаунта. Для публичных публикаций используйте Truth Social User Posts API.
- Не передавайте results_limit или курсор источника; каждая задача выполняет один поиск аккаунта.
Связанные API
Помимо Truth Social Profile API, используйте эти API, когда нужен другой тип публичных данных Truth Social.
- Truth Social Post API — Преобразуйте один известный URL публикации Truth Social в нормализованный контент, контекст автора, медиа, метки времени и доступные поля видимой вовлеченности.
- Truth Social User Posts API — Собирайте одну страницу публичных публикаций Truth Social по имени пользователя или числовому ID аккаунта: нормализованный контент, авторы, медиа, метки времени и видимая вовлеченность.