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, отслеживайте асинхронную задачу и читайте сохраненные нормализованные комментарии с пагинацией результатов задачи.
- Скопируйте канонический публичный URL ролика Snapchat Spotlight, который нужно изучить.
- Отправьте url методом POST на /v1/snapchat/spotlight-comments и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте 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}, курсор которой листает только результаты, уже сохраненные завершенной задачей.
Связанные API
Помимо Snapchat Spotlight Comments API, используйте эти API, когда нужен другой тип публичных данных Snapchat.
- Snapchat Profile API
- Snapchat Spotlight API — Получайте одну известную публичную публикацию Snapchat Spotlight с нормализованными полями автора, подписи, медиа, аудио, метки времени, длительности и видимой вовлеченности, если они доступны.