snapchat/
profile

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

Snapchat Profile API

Поиск по имени пользователя
Публичный профиль
Нормализованный аккаунт
0,19 кредита за запрос
Готово
Готово

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

README

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

Snapchat Profile

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

Возможности Snapchat Profile API

  • Поиск по точному имени пользователяНаходит одно известное имя пользователя Snapchat на задачу, с одним начальным @ или без него, а не ищет аккаунты.
  • Нормализованные данные профиляВозвращает доступные имя пользователя, отображаемое имя, описание профиля, публичный URL и стабильный идентификатор источника в записи AccountItem.
  • Медиа и контекст профиляХранит доступные поля аватара, обложки, сайта и местоположения отдельно для отображения, индексации и обогащения данных.
  • Видимые показатели аккаунтаФиксирует доступные признаки верификации и приватности, а также число подписчиков, подписок и публикаций на момент сбора.

Параметры Snapchat Profile API

ПараметрыОбязательныйОписание
usernameОбязательныйОбязательное имя пользователя Snapchat. Укажите необязательный начальный @, за которым следуют 1–64 символа: латинские буквы ASCII, цифры, точки, подчеркивания или дефисы; пробелы, URL профилей и другие символы отклоняются.

Как использовать Snapchat Profile API

Отправьте одно допустимое имя пользователя, дождитесь завершения асинхронной задачи и прочитайте нормализованный результат профиля.

  1. Выберите одно известное имя пользователя Snapchat из латинских букв, цифр, точек, подчеркиваний или дефисов; один начальный @ необязателен.
  2. Отправьте username на /v1/snapchat/profile и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
  4. После успешного завершения читайте data.results.items; этот запрос данных профиля обычно возвращает один профиль или пустой список.
curl -X POST "https://api.socq.ai/v1/snapchat/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"zane"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after the task succeeds

Сценарии использования Snapchat Profile API

  • Обогащение известных аккаунтов: Добавляйте публичные данные об аккаунте, описание профиля, медиа профиля, сайт и доступные счетчики к записи, в которой уже есть имя пользователя Snapchat.
  • Проверка выбранного профиля: Показывайте один публичный аккаунт в единообразной карточке профиля или очереди на проверку, не смешивая его с историями, Spotlight или действиями по управлению аккаунтом.
  • Сравнение публичных снимков: Сохраняйте collected_at вместе с последовательными результатами, чтобы сравнивать текст публичного профиля, признаки аккаунта, медиа или видимые счетчики во времени.

Практические советы по Snapchat Profile API

  • Храните имя пользователя в одной канонической форме в своих записях, даже если запрос принимает один начальный @.
  • Отправляйте ровно одно имя пользователя на задачу; пакетная передача, URL профилей и results_limit не входят в спецификацию этого эндпоинта.
  • Считайте допустимый синтаксис проверкой входных данных, а не доказательством того, что имя пользователя ведет к доступному публичному профилю.
  • Обрабатывайте сайт, местоположение, медиа профиля, признаки аккаунта и отдельные метрики как необязательные поля.
  • Храните collected_at с каждым сохраненным результатом, потому что текст профиля и видимые счетчики — это значения на определенный момент.

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

  • Snapchat Spotlight API — Получайте одну известную публичную публикацию Snapchat Spotlight с нормализованными полями автора, подписи, медиа, аудио, метки времени, длительности и видимой вовлеченности, если они доступны.
  • Snapchat Spotlight Comments API

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

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

Snapchat Profile API — FAQ

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

Используйте необязательный одиночный @, за которым следуют 1–64 символа: латинские буквы ASCII, цифры, точки, подчеркивания или дефисы. Пробелы, URL профилей и другие знаки препинания не проходят проверку запроса.

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

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

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

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