kwai/
profile

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

Kwai Profile API

Имя пользователя или URL профиля
Нормализованные данные профиля
Задача за 0,19 кредита
0,19 кредита за запрос
Готово
Готово

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

README

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

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

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

  1. Подготовьте корректное имя пользователя или ссылку на профиль Kwai, распознанное имя хоста которой — kwai.com, kwai-video.com или поддомен одного из них.
  2. Отправьте username, url или оба поля на /v1/kwai/profile и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не вернет ошибку.
  4. Читайте профиль в 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 рядом с каждым снимком метрик.

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

  • Kwai User Posts API — Собирайте одну страницу публичных публикаций Kwai по имени пользователя или поддерживаемому URL профиля: нормализованный контент, авторы, медиа, метки времени, хештеги, упоминания и видимая вовлеченность.
  • Kwai Post API — Преобразуйте один известный URL публичной публикации Kwai в нормализованные поля контента, автора, медиа, меток времени, сущностей и видимой вовлеченности.

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

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

Kwai Profile API — FAQ

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

Передайте username, url или оба поля. Имя пользователя может начинаться с одного @, за которым следуют от 1 до 64 латинских букв ASCII, цифр, точек, подчеркиваний или дефисов. Ссылка URL должна распознаваться как kwai.com, kwai-video.com или поддомен; принимается любая схема с authority и именем хоста, а также ссылки без протокола.

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

Нет. Одна задача находит один профиль, и в запросе нет results_limit. Чтение сохраненных результатов при этом предоставляет items, next_cursor и has_more по общей спецификации асинхронных результатов.

Каждая успешная задача Kwai Profile стоит фиксированные 0,19 кредита SocQ. Стоимость не зависит от числа полей или элементов результата.