snapchat/
spotlight-comments

Собирайте одну страницу источника с публичными комментариями к URL ролика Snapchat Spotlight и получайте нормализованные поля текста, автора, связей с веткой, времени и видимой вовлеченности.

Snapchat Spotlight Comments API

URL Spotlight на входе
Одна страница источника
Нормализованные комментарии
0,19 кредита за запрос
Готово
Готово

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

README

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

Snapchat Spotlight Comments

Комментарии к Snapchat Spotlight — это публичные ответы, связанные с одним указанным роликом Spotlight. SocQ сохраняет каждый возвращенный ответ как CommentItem с идентификатором источника, текстом комментария, доступными данными об авторе, ссылками на родительский комментарий и публикацию, временем публикации и сбора и видимым числом лайков или ответов.

Возможности Snapchat Spotlight Comments API

  • Один URL Spotlight на задачуПередайте один непустой url на snapchat.com или поддомене Snapchat; поставщик запрашивает одну страницу источника для этой цели.
  • Нормализованные записи комментариевЧитайте ID комментариев, текст, URL источника, метки времени и доступные данные об авторе в стабильной структуре результата CommentItem 1.0.
  • Контекст ветки и вовлеченностиСохраняет parent_id, post_id, likes_count и replies_count, если источник их передает, не считая отсутствующие поля нулем или признаком полного охвата ветки.

Параметры Snapchat Spotlight Comments API

ПараметрыОбязательныйОписание
urlОбязательныйОбязательный непустой URL Snapchat. Проверка при выполнении принимает snapchat.com и его поддомены; используйте канонический публичный URL вида /@username/spotlight/{spotlight_id}, чтобы поставщик получил нужный ролик Spotlight.

Как использовать Snapchat Spotlight Comments API

Отправьте URL публичного ролика Snapchat Spotlight, отслеживайте асинхронную задачу и читайте сохраненные нормализованные комментарии с пагинацией результатов задачи.

  1. Скопируйте канонический публичный URL ролика Snapchat Spotlight, который нужно изучить.
  2. Отправьте url методом POST на /v1/snapchat/spotlight-comments и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items; если сохраненный результат задачи занимает несколько страниц ответа, продолжайте с next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.snapchat.com/@queenhaley_13/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYY2pnZnF0bG52AZslQsUdAZslQoRQAAAAAQ"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Сценарии использования Snapchat Spotlight Comments API

  • Качественный анализ ответов: Изучайте возвращенный текст публичных комментариев и доступные данные об авторах, чтобы находить вопросы, реакции и повторяющиеся темы вокруг выбранного ролика Spotlight.
  • Архивы комментариев с привязкой к источнику: Сохраняйте ID комментариев, URL источника, post_id, parent_id, published_at и collected_at, чтобы у каждого сохраненного ответа оставалось доступное происхождение.
  • Снимки видимой вовлеченности: Сравнивайте доступные likes_count и replies_count у возвращенных комментариев, привязывая каждое наблюдение к collected_at.

Практические советы по Snapchat Spotlight Comments API

  • Используйте канонический публичный URL вида /@username/spotlight/{spotlight_id}, хотя проверка при выполнении контролирует хост Snapchat, а не точный путь.
  • Не передавайте cursor или results_limit в данных отправки: этот эндпоинт принимает только url и собирает одну страницу поставщика.
  • Считайте parent_id и replies_count доступным контекстом, а не доказательством того, что возвращенные записи содержат полное дерево ответов.
  • Допускайте null в ID, URL, тексте, полях автора, published_at, parent_id, post_id и метриках, если источник их не передает.
  • Отделяйте глубину сбора у поставщика от пагинации GET /v1/tasks/{task_id}, курсор которой листает только результаты, уже сохраненные завершенной задачей.

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

  • Snapchat Profile API
  • Snapchat Spotlight API — Получайте одну известную публичную публикацию Snapchat Spotlight с нормализованными полями автора, подписи, медиа, аудио, метки времени, длительности и видимой вовлеченности, если они доступны.

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

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

Snapchat Spotlight Comments API — FAQ

Snapchat Spotlight Comments API — это программный интерфейс для сбора одной страницы источника с публичными записями комментариев, связанными с указанным URL ролика Snapchat Spotlight.

Спецификация отправки принимает ровно одну обязательную строку url. Проверка при выполнении требует хост snapchat.com или его поддомен; для нужного ресурса используйте канонический публичный формат /@username/spotlight/{spotlight_id}.

Нет. В спецификации отправки нет полей results_limit и cursor, а интеграция с поставщиком выполняет один запрос к источнику.

Этот курсор относится к GET /v1/tasks/{task_id}. Он листает записи комментариев, уже сохраненные для успешной задачи, с лимитом ответа 50 по умолчанию и допустимым диапазоном от 1 до 500; он не загружает еще одну страницу источника Snapchat.

CommentItem 1.0 включает id, platform, resource, type, url, published_at, collected_at, text, author, parent_id, post_id и metrics с likes_count и replies_count. Поля, допускающие null, остаются null, если данные недоступны.

Успешная задача Snapchat Spotlight Comments стоит фиксированные 0,19 кредита SocQ независимо от числа комментариев, возвращенных на этой единственной странице источника.