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
Отправьте один поддерживаемый идентификатор профиля, отслеживайте асинхронную задачу и читайте нормализованный аккаунт из обертки сохраненных результатов.
- Подготовьте полный URL профиля Douyin с путем /user/<identifier> или поддерживаемый публичный user_id.
- Отправьте один идентификатор методом POST на /v1/douyin/user-profile и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- После успешного завершения читайте 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 при сравнении повторных снимков.
Связанные API
Помимо Douyin User Profile API, используйте эти API, когда нужен другой тип публичных данных Douyin.
- Douyin Live Room Detail API — Получайте один известный прямой эфир Douyin по числовому ID: нормализованный контекст эфира, данные ведущего, медиа и видимое число зрителей.
- Douyin User Videos API
- Douyin Video Comments API
- Douyin Video Detail API
- Douyin Video Search API