Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API Snapchat Сведения

POST

Состояние API

Состояние за 24 ч
Норма
Среднее время за 24 ч
—
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

Найдите аккаунт автора или компании в Snapchat по имени пользователя или ссылке на профиль: описание, тип аккаунта, категорию, число подписчиков и число линз, Highlights и Spotlight. has_story показывает, можно ли сейчас посмотреть Story. Закрытые снапы, контакты и юридические данные о личности не охватываются.

Snapchat Details читает публичный профиль одного авторского или бизнес-аккаунта в Snapchat и возвращает одну запись: отображаемое имя, описание, тип аккаунта, категорию и подкатегорию, число подписчиков, статус верификации, сайт и адрес, число линз, Highlights и видео Spotlight, признак того, доступна ли сейчас для просмотра история, а также аватар, изображение шапки и Snapcode. Команды по работе с брендами и блогерами используют её, чтобы оценить аккаунт перед сотрудничеством и отслеживать число его подписчиков во времени.

Передайте имя пользователя, с @ или без него, либо ссылку вида snapchat.com/add/<name> или snapchat.com/@<name>. Читается только публичная информация профиля, но не личные чаты и истории только для друзей. lens_count является одним из ключевых показателей активности авторского аккаунта, а category следует собственной классификации Snapchat, а не кроссплатформенной. snapcode_url ведёт на изображение жёлтого кода, который сканируют, чтобы подписаться на аккаунт, а business_profile_id идентифицирует бизнес-аккаунт.

Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Snapchat Сведения (snapchat/profile).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: snapchat и action: profile, а параметры передайте в params.
- Обязательные параметры:
  - username: Публичное имя автора: имя пользователя (с необязательным префиксом @) или полный URL профиля на snapchat.com.
- Возвращает один объект. Основные поля: business_profile_id, username, display_name, bio, profile_type, category, subcategory, subscriber_count, is_verified, website, address, has_story; всего полей: 21, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=snapchat.
- Пример тела запроса:
{
  "platform": "snapchat",
  "action": "profile",
  "params": {
    "username": "<SNAPCHAT_USERNAME>"
  }
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

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

Параметры запроса

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаsnapchatИдентификатор платформы, фиксированное значение.
actionbodystringДаprofileИдентификатор возможности, фиксированное значение.
usernamebody.paramsstringДа-Публичное имя автора: имя пользователя (с необязательным префиксом @) или полный URL профиля на snapchat.com. Возвращает публичные данные профиля в profile, текущие публичные истории в stories или короткие видео Spotlight в user_posts. Приватные чаты и истории только для друзей недоступны.

Примеры кода

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "snapchat",
  "action": "profile",
  "params": {
    "username": "<SNAPCHAT_USERNAME>"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Предпросмотр полей

Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.

json
{
  "id": "req_…",
  "platform": "snapchat",
  "action": "profile",
  "results": {
    "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": …
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
business_profile_idТрактуется так же, как на самой платформе
usernameИмя пользователя (@handle).
display_nameОтображаемое имя; может отличаться от username.
bioОписание профиля, написанное владельцем аккаунта; может содержать переносы строк и эмодзи.
profile_typeТрактуется так же, как на самой платформе
categoryНазвание категории во внутренней классификации платформы. Категории разных платформ не унифицированы.
subcategoryТрактуется так же, как на самой платформе
subscriber_countТрактуется так же, как на самой платформе
is_verifiedПодтверждён ли аккаунт платформой. null означает, что это невозможно определить.
websiteВнешний сайт, указанный аккаунтом или компанией.
addressПолный адрес передаётся как есть.
has_storyТрактуется так же, как на самой платформе
lens_countТрактуется так же, как на самой платформе
highlight_countТрактуется так же, как на самой платформе
spotlight_countТрактуется так же, как на самой платформе
urlСсылка на запись на платформе.
avatar_urlСсылка на аватар. Некоторые платформы возвращают CDN-ссылки с заданным размером, срок действия которых может истечь.
snapcode_urlТрактуется так же, как на самой платформе
hero_image_urlТрактуется так же, как на самой платформе
created_atВремя создания, в том же формате, что и posted_at.
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).
related_accountsТрактуется так же, как на самой платформе

FAQ

Какие формы username поддерживаются?

Имя аккаунта, с @ или без него, либо ссылка на профиль вида snapchat.com/add/<name> или snapchat.com/@<name>. Отображаемое имя не идентифицирует аккаунт, а ссылка на отдельное видео Spotlight предназначена для возможности Snapchat Video details, а не для этой.

Где поле с числом подписчиков?

Размер аудитории в этом профиле передаётся в subscriber_count, числе подписчиков. Другого поля с размером аудитории нет. Прежде чем сравнивать охват аккаунтов, учитывайте subscriber_count вместе с profile_type: это поле позволяет различать личные аккаунты, аккаунты публичных персон и бизнес-аккаунты.

Что означает has_story?

Значение равно true, если у аккаунта есть история, доступная для просмотра в момент вызова. Чтобы получить сами истории, передайте то же имя пользователя при вызове возможности Snapchat Stories, которая возвращает текущие публичные истории аккаунта.

Ошибки и оплата

401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

  • Snapchat: как различать публичные профили, бизнес-профили и Snap Stars ↗

    Официальная документация отличает публичные профили от личных аккаунтов и отмечает, что наличие публичного профиля не даёт статуса бизнес-профиля или Snap Star. Это определяет типы аккаунтов и условия получения соответствующего статуса, но не распространяет на этот эндпоинт все функции веб-интерфейса.

    Проверено 2026-09-05