kwai/
post

Получайте одну публичную публикацию Kwai по известному URL на kwai.com или kwai-video.com: нормализованный текст, автор, медиа, метки времени и видимая вовлеченность.

Kwai Post API

Известный URL публикации
Публикация и автор
Фиксированная цена задачи
0,19 кредита за запрос
Готово
Готово

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

README

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

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, отслеживайте асинхронную задачу и прочитайте нормализованную запись публикации после завершения.

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

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

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

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

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

Kwai Post API — FAQ

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

Передайте непустой URL, распознанное имя хоста которого — kwai.com, kwai-video.com или один из их поддоменов. Для распознавания имени хоста нужна схема URL.

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

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

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

Каждая успешная задача стоит фиксированные 0,19 кредита SocQ. Оценка не зависит от числа результатов, и успешная задача, не нашедшая ни одной записи, всё равно оплачивается по фиксированной цене задачи.