kwai/
user-posts

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

Kwai User Posts API

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

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

README

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

Kwai User Posts

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

Возможности Kwai User Posts API

  • Два поддерживаемых способа указать аккаунтНачните с имени пользователя или URL публичного профиля на kwai.com или kwai-video.com; хотя бы одно поле идентификации обязательно.
  • Сбор одной страницы публикацийСобирает публикации, которые источник вернул на одной странице для выбранного публичного аккаунта, без курсора источника и без лимита результатов от вызывающей стороны.
  • Нормализованный контент и данные автораПолучайте текст публикации, публичные поля автора, исходные URL, ссылки на медиа, хештеги, упоминания, время публикации и время сбора в единой структуре публикации.
  • Снимки видимой вовлеченностиСохраняет доступное число лайков, комментариев, репостов и просмотров вместе с collected_at, чтобы сравнения были привязаны ко времени наблюдения.

Параметры Kwai User Posts API

ПараметрыОбязательныйОписание
urlОбязательный (хотя бы один)Непустая ссылка на профиль Kwai, распознанное имя хоста которой — kwai.com, kwai-video.com или поддомен одного из них. Допускается любая схема при наличии authority и имени хоста; ссылки без протокола (protocol-relative) тоже принимаются. Укажите url или username; можно передать оба.
usernameОбязательный (хотя бы один)Имя пользователя Kwai с одним необязательным начальным @, за которым следуют от 1 до 64 латинских букв ASCII, цифр, точек, подчеркиваний или дефисов, всего не более 65 символов. Источник получает это значение как handle.

Как использовать Kwai User Posts API

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

  1. Подготовьте имя пользователя Kwai или URL публичного профиля на kwai.com или kwai-video.com.
  2. Отправьте url или username методом POST на /v1/kwai/user-posts и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
  4. Читайте data.results.items и используйте next_cursor результата задачи, пока has_more равно true; этот курсор листает сохраненные результаты, а не источник Kwai.
curl -X POST "https://api.socq.ai/v1/kwai/user-posts" \
  -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 the stored-result next_cursor while has_more is true

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

  • Исследование контента публичного аккаунта: Изучайте подписи, авторство, ссылки на публичные медиа, хештеги, упоминания и время публикации у одного выбранного аккаунта.
  • Анализ форматов медиа: Группируйте полученные публикации по доступному типу медиа, длительности, миниатюре и размерам, сохраняя исходную публикацию и автора.
  • Сравнение вовлеченности на момент сбора: Сравнивайте видимые лайки, комментарии, репосты и просмотры собранных публикаций, используя collected_at для определения окна наблюдения.

Практические советы по Kwai User Posts API

  • Перед отправкой приводите имена пользователей к допустимой форме с необязательным @ и проверяйте, что хост URL профиля — kwai.com или kwai-video.com.
  • Не добавляйте cursor или results_limit в запрос к источнику: каждая задача запрашивает у источника одну страницу, используя только поддерживаемые поля идентификации.
  • Используйте cursor и limit в GET /v1/tasks/{task_id} только после отправки, для постраничного чтения сохраненных результатов задачи; limit принимает значения от 1 до 500, по умолчанию 50.
  • Считайте текст, данные автора, отдельные метрики, медиа, хештеги, упоминания и время публикации необязательными и привязывайте снимки к collected_at.

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

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

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

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

Kwai User Posts API — FAQ

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

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

Нет. В спецификации отправки нет results_limit и курсора источника, а к источнику выполняется один запрос. Курсор в GET /v1/tasks/{task_id} листает только результаты, уже сохраненные для завершенной задачи.

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

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