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, отслеживайте асинхронную задачу и после завершения постранично читайте сохраненные нормализованные результаты.
- Подготовьте имя пользователя Kwai или URL публичного профиля на kwai.com или kwai-video.com.
- Отправьте url или username методом POST на /v1/kwai/user-posts и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
- Читайте 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.
Связанные API
Помимо Kwai User Posts API, используйте эти API, когда нужен другой тип публичных данных Kwai.
- Kwai Profile API — Получайте один публичный профиль Kwai по имени пользователя или поддерживаемому URL: нормализованные данные аккаунта, изображения, признаки аккаунта, видимые счетчики и контекст сбора.
- Kwai Post API — Преобразуйте один известный URL публичной публикации Kwai в нормализованные поля контента, автора, медиа, меток времени, сущностей и видимой вовлеченности.