snapchat/
spotlight

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

Snapchat Spotlight API

Один URL Spotlight
Контекст автора
Снимок видео
0,19 кредита за запрос
Готово
Готово

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

README

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

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

  1. Скопируйте URL публичного ролика Snapchat Spotlight на snapchat.com или одном из его поддоменов.
  2. Отправьте URL в поле url на /v1/snapchat/spotlight и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
  4. Читайте 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 кредита на каждую успешную задачу; фиксированная плата не зависит от возвращенных полей или числа результатов.

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

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

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

Snapchat Spotlight API — FAQ

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

Отправьте непустой URL с http или https, хост которого — snapchat.com или поддомен, например www.snapchat.com; проверка при выполнении не требует определенного пути, но поставщик ожидает публичную ссылку на Spotlight.

Нет. Вход принимает только url и выполняет один запрос данных ролика, поэтому эндпоинт не находит ленту и не принимает results_limit.

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

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

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