Snapchat Profile
Публичный профиль Snapchat может содержать имя пользователя, отображаемое имя, описание профиля, аватар, обложку, сайт, признаки аккаунта, местоположение и видимые счетчики профиля. Этот точечный запрос превращает одно известное имя пользователя в нормализованный снимок аккаунта для обогащения данных, проверки или последующего сравнения.
Возможности Snapchat Profile API
- Поиск по точному имени пользователяНаходит одно известное имя пользователя Snapchat на задачу, с одним начальным @ или без него, а не ищет аккаунты.
- Нормализованные данные профиляВозвращает доступные имя пользователя, отображаемое имя, описание профиля, публичный URL и стабильный идентификатор источника в записи AccountItem.
- Медиа и контекст профиляХранит доступные поля аватара, обложки, сайта и местоположения отдельно для отображения, индексации и обогащения данных.
- Видимые показатели аккаунтаФиксирует доступные признаки верификации и приватности, а также число подписчиков, подписок и публикаций на момент сбора.
Параметры Snapchat Profile API
| Параметры | Обязательный | Описание |
|---|---|---|
username | Обязательный | Обязательное имя пользователя Snapchat. Укажите необязательный начальный @, за которым следуют 1–64 символа: латинские буквы ASCII, цифры, точки, подчеркивания или дефисы; пробелы, URL профилей и другие символы отклоняются. |
Как использовать Snapchat Profile API
Отправьте одно допустимое имя пользователя, дождитесь завершения асинхронной задачи и прочитайте нормализованный результат профиля.
- Выберите одно известное имя пользователя Snapchat из латинских букв, цифр, точек, подчеркиваний или дефисов; один начальный @ необязателен.
- Отправьте username на /v1/snapchat/profile и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
- После успешного завершения читайте 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 с каждым сохраненным результатом, потому что текст профиля и видимые счетчики — это значения на определенный момент.
Связанные API
Помимо Snapchat Profile API, используйте эти API, когда нужен другой тип публичных данных Snapchat.
- Snapchat Spotlight API — Получайте одну известную публичную публикацию Snapchat Spotlight с нормализованными полями автора, подписи, медиа, аудио, метки времени, длительности и видимой вовлеченности, если они доступны.
- Snapchat Spotlight Comments API