Snapchat Spotlight
Запись о публичном ролике Snapchat Spotlight может содержать ссылку на источник, подпись, данные об авторе, ссылки на медиа, время публикации, длительность, сведения об аудио и видимые показатели вовлеченности. Нормализованный результат хранит эти доступные поля вместе с меткой времени сбора, чтобы проверять выбранные видео, обогащать каталоги и сравнивать данные на определенный момент времени.
Возможности Snapchat Spotlight API
- Обработка известного ролика SpotlightПередайте один публичный URL на snapchat.com, и ответ с данными ролика будет преобразован не более чем в одну стандартную запись без раскрытия ленты.
- Контекст автора и видеоХранит URL источника и доступные подпись, данные об авторе, медиа, длительность, аудио, хештеги, упоминания и время публикации в одной фиксированной структуре результата.
- Снимок видимой вовлеченностиВозвращает доступное число лайков, комментариев, репостов, воспроизведений и просмотров вместе с collected_at, чтобы последующий анализ сохранял время наблюдения.
Параметры Snapchat Spotlight API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный | Обязательный непустой URL с http или https, хост которого — snapchat.com или любой его поддомен. Проверка при выполнении не задает правило для пути; используйте публичную ссылку на Spotlight, например /@username/spotlight/{spotlight_id}. |
Как использовать Snapchat Spotlight API
Отправьте один URL публичного ролика Snapchat Spotlight, отслеживайте асинхронную задачу и прочитайте сохраненный нормализованный результат.
- Скопируйте URL публичного ролика Snapchat Spotlight на snapchat.com или одном из его поддоменов.
- Отправьте URL в поле url на /v1/snapchat/spotlight и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
- Читайте data.results.items; если ответ с сохраненными результатами возвращает has_more, продолжайте с его next_cursor.
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight" \
-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; next_cursor paginates stored results onlyСценарии использования Snapchat Spotlight API
- Проверка выбранного ролика Spotlight: Превращайте известную публичную ссылку в отслеживаемую запись с полями источника, подписи, автора, медиа, времени и доступной вовлеченности.
- Обогащение каталога контента: Добавляйте нормализованные идентификаторы видео, контекст автора, длительность, аудио, хештеги, упоминания и время сбора к существующему списку URL.
- Сравнение зафиксированной вовлеченности: Связывайте видимые счетчики с collected_at при сравнении отдельных наблюдений, не считая эти значения актуальными в реальном времени или полными.
Практические советы по Snapchat Spotlight API
- Передавайте ровно один URL в url; массивы, results_limit, usernames и callback_url этот эндпоинт не принимает.
- Используйте публичную ссылку на Spotlight, хотя проверка контролирует только хост Snapchat, а не путь: посторонние пути Snapchat могут завершиться ошибкой у поставщика.
- Не считайте next_cursor результатов задачи пагинацией ленты источника: запрос к поставщику — это один запрос данных ролика, который дает не более одной записи.
- Допускайте null в ID, подписях, полях автора, медиа, метках времени, аудио и отдельных метриках, если публичный ответ их не содержит.
- Сохраняйте collected_at рядом со счетчиками вовлеченности, чтобы каждый замер оставался привязан ко времени сбора.
- Закладывайте в бюджет 0,19 кредита на каждую успешную задачу; фиксированная плата не зависит от возвращенных полей или числа результатов.
Связанные API
Помимо Snapchat Spotlight API, используйте эти API, когда нужен другой тип публичных данных Snapchat.