Ко всем API
Публичные данные Snapchat

Snapchat Public Data API

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

Доступный API Snapchat

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

Какие данные Snapchat можно получить?

SocQ преобразует один известный публичный ролик Spotlight в фиксированную запись ReelVideoItem и сохраняет только те поля, которые есть в ответе источника.

Идентификация и источник Spotlight

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

Подпись и контекст автора

Возвращайте доступный текст, а также ID автора, имя пользователя, отображаемое имя, URL профиля, аватар, признаки верификации и приватности.

Видео, аудио и таксономия

Сохраняйте в нормализованной записи доступные ссылки на медиа, длительность, метаданные аудио, shortcode, хештеги и упоминания.

Видимая вовлеченность

Фиксируйте доступное число лайков, комментариев, репостов, воспроизведений и просмотров как публичные значения на момент сбора.

SocQ vs продуктовые инструменты Snapchat

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

ВозможностьSocQИнструменты Snapchat
Основное назначениеПолучение данных одного известного публичного ролика SpotlightСоздание, публикация, управление, анализ и продвижение авторизованного контента
АутентификацияAPI-ключ SocQАккаунт Snapchat, приложение, токен или авторизация конкретного продукта
Входные данныеОдин публичный URL на snapchat.comКонтекст авторизованного аккаунта или продукта
Публикация и управление контентомНе поддерживаетсяДоступно в соответствующем продукте Snapchat
Формат ответаНормализованная запись ReelVideoItemОбъекты и интерфейсы конкретного продукта Snapchat

Как работает API Snapchat

Snapchat Spotlight использует асинхронную задачу с последующим получением сохраненного результата.

  1. 1. Отправьте публичный URL

    Отправьте один URL ролика Spotlight на snapchat.com и сохраните возвращенный task_id.

  2. 2. Отслеживайте задачу

    Опрашивайте /v1/tasks/{task_id}, пока обработка не завершится успешно или с ошибкой.

  3. 3. Прочитайте сохраненный результат

    Читайте data.results.items и используйте next_cursor, только если общий механизм чтения задач сообщает о дополнительных сохраненных записях.

Получение одного ролика Snapchat Spotlight

Пройдите аутентификацию с API-ключом SocQ и отправьте один публичный URL ролика Spotlight.

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

Типичные сценарии использования API Snapchat

Исследование отобранного контента

Превращайте отобранный URL ролика Spotlight в отслеживаемую запись для проверки и разметки.

Обогащение каталога

Добавляйте к существующей коллекции ссылок доступные поля автора, подписи, медиа, аудио, длительности, таксономии и временных меток.

Снимки вовлеченности

Сравнивайте видимые метрики между отдельными сборами, сохраняя collected_at как время наблюдения.

Ограничения и политика публичных данных

Результаты Snapchat Spotlight — это публичные записи на момент сбора; авторизованные операции с аккаунтами Snapchat не предоставляются.

  • Тело запроса принимает ровно одно обязательное поле url и отклоняет лишние поля, например results_limit или callback_url.
  • Валидация принимает snapchat.com и его поддомены, но не проверяет путь; используйте публичную ссылку на Spotlight, потому что запросы с посторонними путями могут завершиться ошибкой у провайдера.
  • Провайдер выполняет один запрос данных и возвращает не более одной нормализованной записи, а не ленту Spotlight.
  • Пагинация сохраненных результатов относится к общему механизму чтения задач и не является пагинацией источника Snapchat.
  • Необязательные поля подписи, автора, медиа, публикации, аудио, длительности, таксономии и метрик могут быть null.
  • Эндпоинт не входит в аккаунт, не публикует, не редактирует, не удаляет, не модерирует, не управляет аккаунтами и не работает с рекламой.

Частые вопросы об API Snapchat

Что получает Snapchat Spotlight API?

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

Собирает ли API Snapchat ленту Spotlight?

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

Обновляются ли возвращаемые счетчики вовлеченности в реальном времени?

Нет. Считайте доступные счетчики публичным снимком на момент collected_at, а не полной или постоянно обновляемой аналитикой.

Может ли SocQ публиковать в Snapchat?

Нет. Этот эндпоинт публичных данных не предоставляет вход в аккаунт, публикацию, управление аккаунтом, модерацию или операции с рекламой.

Сколько стоит Snapchat Spotlight?

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

Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.

Twitch API

Превращайте известное публичное имя пользователя Twitch в нормализованный профиль, собирайте его публичные видео или получайте отдельный клип вместе со скачиваемым видео для исследования авторов, обогащения каталогов, сравнения и мониторинга снимков.

Rednote API

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

Kwai API

Получайте публичные профили Kwai, одну страницу публикаций аккаунта или одну известную публикацию с нормализованными данными об идентичности, контентом, медиа, метками времени и видимой вовлеченностью.

Truth Social API

Получайте публичные данные аккаунта, собирайте одну исходную страницу публикаций аккаунта или превращайте один известный URL публикации в нормализованные записи.

Google Ad Library API

Находите публичных рекламодателей, собирайте креативы компании или получайте один известный креатив из Transparency Center по URL для исследований и проверки.

Google Maps API

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