Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Snapchat: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Профилиprofile | Найдите аккаунт автора или компании в Snapchat по имени пользователя или ссылке на профиль: описание, тип аккаунта, категорию, число подписчиков и число линз, Highlights и Spotlight. | $1.39 за 1 000 запросов | Норма |
Историиstories | Получите Stories, которые сейчас опубликованы в аккаунте Snapchat: ID истории, заголовок, ссылку на медиа, превью и время публикации. | $1.39 за 1 000 запросов | Норма |
Посты пользователяuser_posts | Соберите видео Spotlight аккаунта Snapchat: подпись, ссылку на медиа, длительность, размеры и число просмотров, репостов, комментариев, бустов и рекомендаций. | $1.39 за 1 000 запросов | Норма |
Сведения о видеоvideo | Получите одно видео Snapchat Spotlight по точной ссылке на видео: текст подписи, хештеги, просмотры, репосты, длительность, а также имя и профиль автора. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Snapchat?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
profileПрофили Найдите аккаунт автора или компании в Snapchat по имени пользователя или ссылке на профиль: описание, тип аккаунта, категорию, число подписчиков и число линз, Highlights и Spotlight. | username | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | business_profile_id · username · display_name · bio · profile_type · category · subcategory · subscriber_count · is_verified · website · address · has_story · lens_count · highlight_count · spotlight_count · url · avatar_url · snapcode_url · hero_image_url · created_at · platform · related_accounts |
storiesИстории Получите Stories, которые сейчас опубликованы в аккаунте Snapchat: ID истории, заголовок, ссылку на медиа, превью и время публикации. Stories только для друзей недоступны, полный охват периода доступности Story не гарантируется. | username | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · story_id · story_title · media_url · thumbnail_url · posted_at · username · author_name · author_url · platform |
user_postsПосты пользователя Соберите видео Spotlight аккаунта Snapchat: подпись, ссылку на медиа, длительность, размеры и число просмотров, репостов, комментариев, бустов и рекомендаций. Длительность указана в миллисекундах; чаты и полный архив не включаются. | username | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · title · text · summary · caption · media_url · thumbnail_url · duration_ms · width · height · view_count · share_count · comment_count · boost_count · recommend_count · posted_at · username · author_name · author_url · platform |
videoСведения о видео Получите одно видео Snapchat Spotlight по точной ссылке на видео: текст подписи, хештеги, просмотры, репосты, длительность, а также имя и профиль автора. Ссылки на профили и add/ здесь не принимаются. Ссылка на медиа не гарантирует постоянного доступа или прав на повторное использование. | url | spotlight_url | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · text · hashtags · view_count · share_count · duration_ms · posted_at · thumbnail_url · media_url · username · author_name · author_url · author_avatar_url · platform |
Что означают параметры действия profile в API Snapchat?
Найдите аккаунт автора или компании в Snapchat по имени пользователя или ссылке на профиль: описание, тип аккаунта, категорию, число подписчиков и число линз, Highlights и Spotlight. has_story показывает, можно ли сейчас посмотреть Story. Закрытые снапы, контакты и юридические данные о личности не охватываются.
usernameОбязательный- Публичное имя автора: имя пользователя (с необязательным префиксом
@) или полный URL профиля на snapchat.com. Возвращает публичные данные профиля вprofile, текущие публичные истории вstoriesили короткие видео Spotlight вuser_posts. Приватные чаты и истории только для друзей недоступны.Snapchat: как различать публичные профили, бизнес-профили и Snap Stars — Официальная документация отличает публичные профили от личных аккаунтов и отмечает, что наличие публичного профиля не даёт статуса бизнес-профиля или Snap Star. Это определяет типы аккаунтов и условия получения соответствующего статуса, но не распространяет на этот эндпоинт все функции веб-интерфейса. · Проверено
Что означают параметры действия stories в API Snapchat?
Получите Stories, которые сейчас опубликованы в аккаунте Snapchat: ID истории, заголовок, ссылку на медиа, превью и время публикации. Stories только для друзей недоступны, полный охват периода доступности Story не гарантируется.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Публичное имя автора: имя пользователя (с необязательным префиксом
@) или полный URL профиля на snapchat.com. Возвращает публичные данные профиля вprofile, текущие публичные истории вstoriesили короткие видео Spotlight вuser_posts. Приватные чаты и истории только для друзей недоступны.Snapchat: границы доступности публичных историй и историй только для друзей — Официальная документация уточняет, что активные публичные истории доступны со страниц публичных профилей, а My Story · Friends видна только друзьям. EveryInfra работает только с доступными сейчас публичными историями и не обязуется получать истории только для друзей, истёкшие истории или архивные материалы. · Проверено
Что означают параметры действия user_posts в API Snapchat?
Соберите видео Spotlight аккаунта Snapchat: подпись, ссылку на медиа, длительность, размеры и число просмотров, репостов, комментариев, бустов и рекомендаций. Длительность указана в миллисекундах; чаты и полный архив не включаются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Публичное имя автора: имя пользователя (с необязательным префиксом
@) или полный URL профиля на snapchat.com. Возвращает публичные данные профиля вprofile, текущие публичные истории вstoriesили короткие видео Spotlight вuser_posts. Приватные чаты и истории только для друзей недоступны.Snapchat: Spotlight как отдельный раздел публичного контента — Официальная документация описывает Spotlight как центральный раздел для поиска снапов сообщества, доступный также для просмотра в вебе. Это определение касается только типов контента: из него не следует, что эндпоинт поддерживает поиск в Spotlight, загрузку или полную фильтрацию трендов. · Проверено
Что означают параметры действия video в API Snapchat?
Получите одно видео Snapchat Spotlight по точной ссылке на видео: текст подписи, хештеги, просмотры, репосты, длительность, а также имя и профиль автора. Ссылки на профили и add/ здесь не принимаются. Ссылка на медиа не гарантирует постоянного доступа или прав на повторное использование.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Точный URL видео Spotlight, обязательный для действия
video. Эндпоинты видео не принимают вместо него ссылки на профиль или ссылкиadd/. В действиях с профилями полный URL используется только как запасной вариант для извлечения имени автора.Snapchat Spotlight: общее число просмотров отличается от числа уникальных зрителей — Официальная документация отличает общее число запусков воспроизведения (Views) от уникальных зрителей (Viewers), пересылок и комментариев. Параметр view_count в EveryInfra нельзя переопределять как число уникальных зрителей; время просмотра в панели статистики, демография аудитории и дополнительные метрики для авторизованных пересылок не входят в число гарантий этого эндпоинта. · Проверено spotlight_urlНеобязательный- Дополнительный параметр совместимости для действия
videoс более низким приоритетом, чем уurl. В обычных запросах публичных видео передавайтеurlнапрямую.
Как использовать API Snapchat
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"snapchat","action":"profile","params":{"username":"<username>"}}'
Вопросы об API Snapchat
Какие данные можно получить через API Snapchat?
Укажите в platform значение snapchat. В текущем каталоге: профили, истории, посты пользователя и сведения о видео. Эти названия действий соответствуют разным объектам или представлениям Snapchat; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса profile к платформе Snapchat?
Публичное имя автора: имя пользователя (с необязательным префиксом @) или полный URL профиля на snapchat.com. Возвращает публичные данные профиля в profile, текущие публичные истории в stories или короткие видео Spotlight в user_posts. Приватные чаты и истории только для друзей недоступны. Передайте это значение в поле username объекта params.
Какие поля может вернуть profile на платформе Snapchat?
Объявленная схема включает business_profile_id, username, display_name и bio. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Snapchat возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.