Kwai Post
Публикации Kwai — это публичные записи контента, в которых текст и медиа могут сочетаться с данными автора, хештегами, упоминаниями, временем публикации и видимой вовлеченностью. Эти поля помогают обогащать каталоги URL, проверять контент и сравнивать выбранные публикации на определенный момент времени.
Возможности Kwai Post API
- Поиск по одному известному URLОбрабатывает один публичный URL на kwai.com, kwai-video.com или их поддоменах без дополнительного непроверенного правила для пути.
- Контекст публикации и автораВозвращает идентификатор публикации, исходный URL, текст, время публикации и доступные ID автора, имя пользователя, отображаемое имя, URL профиля, аватар и признаки аккаунта.
- Медиа и сущности контентаСохраняет доступные ссылки на медиа, превью, размеры, длительность, хештеги и упоминания вместе с записью публикации.
- Снимок видимой вовлеченностиНормализует доступное число лайков, комментариев, репостов и просмотров вместе с collected_at, чтобы у записи было четкое время наблюдения.
Параметры Kwai Post API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный | Обязательный непустой URL с распознаваемым именем хоста kwai.com или kwai-video.com, включая поддерживаемые поддомены. Определенный шаблон пути при выполнении не требуется. |
Как использовать Kwai Post API
Отправьте один допустимый URL Kwai, отслеживайте асинхронную задачу и прочитайте нормализованную запись публикации после завершения.
- Убедитесь, что URL содержит распознаваемое имя хоста на kwai.com, kwai-video.com или допустимом поддомене.
- Отправьте строку url методом POST на /v1/kwai/post и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- После успешного завершения читайте data.results.items. Источник детальных данных может сохранить не более одной публикации, поэтому has_more обычно равно false, хотя маршрут результатов задачи и предоставляет next_cursor.
curl -X POST "https://api.socq.ai/v1/kwai/post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.kwai.com/@ShortShortz8/photo/5235021727595785285"}'
# Poll GET /v1/tasks/{task_id}
# Read the normalized post from data.results.itemsСценарии использования Kwai Post API
- Обогащение каталога известных публикаций: Заменяйте сохраненную ссылку Kwai нормализованными ID публикации, текстом, данными автора, временем публикации и полями источника.
- Проверка контента выбранных публикаций: Используйте текст, ссылки на медиа, хештеги, упоминания и контекст автора, чтобы проверять утвержденный набор отдельных публикаций.
- Сравнение снимков вовлеченности: Повторяйте запросы в заданное время и сопоставляйте видимое число лайков, комментариев, репостов и просмотров с collected_at для сравнения на определенный момент.
Практические советы по Kwai Post API
- Указывайте схему URL, чтобы имя хоста можно было распознать, и используйте точную публичную ссылку на публикацию, а не просто имя аккаунта.
- Отправляйте один URL на задачу: этот эндпоинт детальных данных принимает одно поле url и не поддерживает results_limit или пакетный ввод.
- Сохраняйте отправленный URL, если успешная задача не вернула элемента: допустимое имя хоста не гарантирует, что источник сможет найти ресурс.
- Храните необязательные поля автора, медиа, сущностей и вовлеченности с запасом на их отсутствие: публичная публикация может раскрывать не все нормализованные поля.
- Используйте collected_at при каждом сравнении метрик и не считайте видимые счетчики потоком данных в реальном времени.
Связанные API
Помимо Kwai Post API, используйте эти API, когда нужен другой тип публичных данных Kwai.
- Kwai Profile API — Получайте один публичный профиль Kwai по имени пользователя или поддерживаемому URL: нормализованные данные аккаунта, изображения, признаки аккаунта, видимые счетчики и контекст сбора.
- Kwai User Posts API — Собирайте одну страницу публичных публикаций Kwai по имени пользователя или поддерживаемому URL профиля: нормализованный контент, авторы, медиа, метки времени, хештеги, упоминания и видимая вовлеченность.