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. Отправьте публичный URL
Отправьте один URL ролика Spotlight на snapchat.com и сохраните возвращенный task_id.
2. Отслеживайте задачу
Опрашивайте /v1/tasks/{task_id}, пока обработка не завершится успешно или с ошибкой.
3. Прочитайте сохраненный результат
Читайте data.results.items и используйте next_cursor, только если общий механизм чтения задач сообщает о дополнительных сохраненных записях.
Пройдите аутентификацию с 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 и собирайте публичные отзывы с привязанным к источнику контекстом места и автора.


