Kwai Profile
Профили Kwai — это публичные страницы аккаунтов с именами пользователей, отображаемыми именами, описаниями профиля, изображениями профиля, сайтами, признаками аккаунта и видимым числом подписчиков, подписок и публикаций. Эти сведения об аккаунте и сигналы на определенный момент помогают обогащать профили, сравнивать аккаунты и регулярно отслеживать снимки профилей.
Возможности Kwai Profile API
- Два поддерживаемых идентификатораНаходит один публичный профиль по корректному имени пользователя, URL профиля на kwai.com или kwai-video.com либо по обоим идентификаторам в одной задаче.
- Нормализованные публичные данныеВозвращает ID профиля, исходный URL, имя пользователя, отображаемое имя, текст описания профиля, аватар, обложку и сайт в единой записи аккаунта.
- Признаки аккаунта со временем наблюденияХранит доступные признаки верификации и приватности, видимое число подписчиков, подписок и публикаций и collected_at вместе как снимок профиля на определенный момент.
Параметры Kwai Profile API
| Параметры | Обязательный | Описание |
|---|---|---|
username | Обязательный (хотя бы один) | Обязательно одно из полей: username или url. Имя пользователя может начинаться с @, за которым следуют от 1 до 64 латинских букв ASCII, цифр, точек, подчеркиваний или дефисов. |
url | Обязательный (хотя бы один) | Обязательно одно из полей: url или username. Непустая ссылка должна распознаваться как имя хоста kwai.com, kwai-video.com или поддомен одного из них. Допускается любая схема при наличии authority и имени хоста; ссылки без протокола (protocol-relative) тоже принимаются. |
Как использовать Kwai Profile API
Отправьте один поддерживаемый идентификатор, отслеживайте асинхронную задачу и прочитайте нормализованную запись профиля со страницы сохраненных результатов.
- Подготовьте корректное имя пользователя или ссылку на профиль Kwai, распознанное имя хоста которой — kwai.com, kwai-video.com или поддомен одного из них.
- Отправьте username, url или оба поля на /v1/kwai/profile и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не вернет ошибку.
- Читайте профиль в data.results.items и переходите по next_cursor, только если has_more равно true.
curl -X POST "https://api.socq.ai/v1/kwai/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.kwai.com/@ShortShortz8"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor only while has_more is trueСценарии использования Kwai Profile API
- Обогащение записей профилей: Добавляйте нормализованные публичные данные, изображения профиля, сайт, признаки аккаунта и исходный URL в запись, связанную с известным аккаунтом Kwai.
- Сравнение видимых показателей аккаунтов: Сравнивайте доступное число подписчиков, подписок и публикаций у выбранных профилей, не считая эти значения итогами в реальном времени.
- Мониторинг снимков профиля: Сохраняйте повторные результаты с collected_at, чтобы отслеживать изменения публичных данных, признаков аккаунта и видимых счетчиков во времени.
Практические советы по Kwai Profile API
- Передавайте хотя бы один идентификатор. Если указаны и username, и url, бэкенд передает оба, а не выбирает один за вас.
- Проверяйте имена пользователей выражением ^@?[A-Za-z0-9._-]{1,64}$ и перед отправкой убеждайтесь, что распознанное имя хоста URL — kwai.com, kwai-video.com или поддомен.
- Считайте описание профиля, аватар, обложку, сайт, признаки аккаунта и отдельные метрики необязательными: публичный профиль может раскрывать лишь часть схемы.
- Используйте id как основной ключ дедупликации, при необходимости переходите на url и храните collected_at рядом с каждым снимком метрик.
Связанные API
Помимо Kwai Profile API, используйте эти API, когда нужен другой тип публичных данных Kwai.
- Kwai User Posts API — Собирайте одну страницу публичных публикаций Kwai по имени пользователя или поддерживаемому URL профиля: нормализованный контент, авторы, медиа, метки времени, хештеги, упоминания и видимая вовлеченность.
- Kwai Post API — Преобразуйте один известный URL публичной публикации Kwai в нормализованные поля контента, автора, медиа, меток времени, сущностей и видимой вовлеченности.