douyin/
user-profile

Получайте один публичный профиль Douyin по поддерживаемому URL профиля или идентификатору пользователя: нормализованные данные об аккаунте, описание профиля, изображения, признаки аккаунта и видимые счетчики.

Douyin User Profile API

URL или ID пользователя
Один публичный профиль
Нормализованные поля аккаунта
0,1 кредита за запрос
Готово
Готово

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

README

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

Douyin User Profile

Профили пользователей Douyin — это публичные страницы аккаунтов с данными об аккаунте, описанием профиля, изображениями профиля, признаками верификации и приватности, а также видимым числом подписчиков, подписок и публикаций. Эти поля помогают обогащать данные об аккаунтах, проверять идентичность, отслеживать снимки профилей и сравнивать профили между собой.

Возможности Douyin User Profile API

  • Два поддерживаемых идентификатораНаходит один публичный профиль по поддерживаемому URL пользователя Douyin или по user_id, который соответствует правилу для идентификаторов.
  • Идентификация и оформление профиляВозвращает доступные ID профиля, публичный URL, имя пользователя, отображаемое имя, описание профиля, аватар, обложку и связанный сайт в одной записи аккаунта.
  • Явные поля состояния аккаунтаСохраняет доступные признаки верификации и приватности как значения, допускающие null, и не додумывает состояние, если публичный источник его не дает.
  • Видимые показатели профиляНормализует доступное число подписчиков, подписок и публикаций вместе с collected_at, чтобы получить срез публичного профиля на определенный момент.

Параметры Douyin User Profile API

ПараметрыОбязательныйОписание
urlОбязательный (хотя бы один)Укажите url или user_id. Непустой URL должен относиться к douyin.com, iesdouyin.com или их поддомену и содержать путь /user/<identifier>.
user_idОбязательный (хотя бы один)Укажите user_id или url. user_id принимает от 1 до 256 символов ASCII: латинские буквы, цифры, двоеточия, подчеркивания или дефисы; если переданы оба поля, приоритет у user_id.

Как использовать Douyin User Profile API

Отправьте один поддерживаемый идентификатор профиля, отслеживайте асинхронную задачу и читайте нормализованный аккаунт из обертки сохраненных результатов.

  1. Подготовьте полный URL профиля Douyin с путем /user/<identifier> или поддерживаемый публичный user_id.
  2. Отправьте один идентификатор методом POST на /v1/douyin/user-profile и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. После успешного завершения читайте data.results.items; поиск в источнике дает не более одного профиля, но обертка сохраненных результатов всё равно содержит has_more и next_cursor.
curl -X POST "https://api.socq.ai/v1/douyin/user-profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"user_id\":\"${DOUYIN_USER_ID}\"}"

# Poll GET /v1/tasks/{task_id}
# Read the normalized account from data.results.items

Сценарии использования Douyin User Profile API

  • Обогащение записей об авторах: Добавляйте доступные данные об аккаунте Douyin, описание профиля, изображения, сайт, признаки аккаунта и публичные счетчики к имеющейся записи об авторе.
  • Проверка идентичности профиля: Превращайте известный URL профиля или идентификатор пользователя в единообразный объект аккаунта, прежде чем связывать его с внутренней сущностью.
  • Сравнение публичных аккаунтов: Сравнивайте число подписчиков, подписок и публикаций у отдельно собранных профилей по одним и тем же нормализованным ключам метрик.
  • Мониторинг снимков профиля: Сохраняйте поля идентификации и публичные метрики вместе с collected_at, чтобы последующие задачи оставались различимыми наблюдениями на определенный момент.

Практические советы по Douyin User Profile API

  • Если канонический идентификатор пользователя уже известен, отправляйте только user_id; если url и user_id не совпадают, запрос к поставщику использует user_id.
  • Перед отправкой URL проверяйте имя хоста и наличие пути /user/<identifier>, чтобы ссылки на видео и другие ресурсы Douyin отклонялись еще на вашей стороне.
  • Ожидайте ноль или одну запись профиля из источника; курсор при чтении задачи разбивает на страницы сохраненные элементы SocQ и не может запросить у поставщика еще одну страницу для этого поиска.
  • Считайте данные идентификации, изображения, сайт, признаки аккаунта, местоположение и каждую метрику допускающими null и сохраняйте collected_at при сравнении повторных снимков.

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

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

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

Douyin User Profile API — FAQ

Douyin User Profile API получает один публичный аккаунт Douyin по поддерживаемому URL профиля или идентификатору пользователя и возвращает нормализованные данные об аккаунте, описание профиля, изображения, признаки аккаунта, видимые счетчики и время сбора.

Любое из этих полей удовлетворяет требованиям запроса. Отправляйте только тот идентификатор, по которому хотите найти профиль, потому что при наличии обоих значений приоритет у user_id.

Распознанное имя хоста должно быть douyin.com, iesdouyin.com или их поддоменом, а путь должен содержать /user/ и идентификатор из букв, цифр, подчеркиваний или дефисов. Ссылки на видео и посторонние хосты отклоняются.

Схема аккаунта может содержать ID и URL профиля, имя пользователя, отображаемое имя, описание профиля, аватар, обложку, сайт, признаки верификации и приватности, местоположение, число подписчиков, подписок и публикаций, а также collected_at. Необязательные публичные поля остаются null, если значение недоступно.

Нет. Поиск у поставщика — это один запрос на получение данных, который дает не более одного профиля из источника; next_cursor и has_more описывают только пагинацию по результатам, уже сохраненным SocQ.

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