Pinterest Profiles
Профили Pinterest — это публичные страницы аккаунтов с именем пользователя, отображаемым именем, описанием профиля, изображением профиля, связанным сайтом и видимым числом подписчиков, подписок, досок и сохранений. Эти поля идентичности и сигналы аккаунта помогают обогащать профили, сравнивать публичные аккаунты и отслеживать изменения во времени.
Возможности Pinterest Profiles API
- Только публичные URL профилейОбрабатывает один или несколько поддерживаемых URL профилей Pinterest, исключая ссылки на пины, короткие ссылки, страницы поиска и другие пути, не ведущие на профиль.
- Идентичность и оформление профиляВозвращает ID профиля, канонический URL, имя пользователя, отображаемое имя, описание профиля, изображение профиля и связанный сайт в одной нормализованной записи.
- Видимые счетчики аккаунтаСохраняет доступное число подписчиков, подписок, досок и сохранений как отдельные метрики для сравнения на уровне аккаунтов.
- Контекст сбора и источникаДобавляет collected_at, а также доступные код страны, URL страницы созданных пинов, значение обновления источника и исходный запрос, не смешивая их с полями идентичности.
Параметры Pinterest Profiles API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный список URL публичных профилей Pinterest. Каждый URL должен использовать HTTP или HTTPS на домене Pinterest и содержать один незарезервированный сегмент пути с именем пользователя. |
Как использовать Pinterest Profiles API
Отправьте известные URL публичных профилей, отслеживайте асинхронную задачу и читайте нормализованные записи профилей с курсорной пагинацией.
- Подготовьте один или несколько URL публичных профилей Pinterest, путь которых содержит один сегмент с именем пользователя.
- Отправьте ссылки в urls на /v1/pinterest/profiles и сохраните task_id.
- Опрашивайте /v1/tasks/{task_id}, пока обработка не завершится успешно или с ошибкой.
- Читайте data.results.items и запрашивайте следующую страницу с next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/pinterest/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/example/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования Pinterest Profiles API
- Обогащение публичных профилей: Добавляйте имя пользователя, отображаемое имя, описание профиля, изображение профиля, сайт и страну к записям, связанным с известными URL профилей.
- Сравнение масштаба аккаунтов: Сравнивайте видимое число подписчиков, подписок, досок и сохранений в выбранном наборе публичных профилей.
- Мониторинг публичных профилей: Сохраняйте поля идентичности и видимые метрики вместе с collected_at, чтобы сравнивать оформление профиля и сигналы аккаунта в разные моменты сбора.
Практические советы по Pinterest Profiles API
- Используйте полный URL профиля Pinterest с HTTP или HTTPS и одним сегментом пути с именем пользователя; pin.it, /pin/, /search/ и другие зарезервированные пути отклоняются.
- Нормализуйте переданные URL и убирайте дубли возвращенных профилей по id, если он есть, а в качестве резервного стабильного ключа используйте url.
- Считайте описание профиля, изображение, сайт, код страны, значение обновления источника, URL страницы созданных пинов и отдельные метрики необязательными полями.
- Храните collected_at рядом с видимыми счетчиками аккаунта, чтобы последующие запуски оставались различимыми как отдельные публичные снимки.
- Используйте Pinterest User Pins API, если вам нужны записи пинов из профиля: этот эндпоинт возвращает метаданные и счетчики профиля, а не доски, пины или списки аудитории.
Связанные API
Помимо Pinterest Profiles API, используйте эти API, когда нужен другой тип публичных данных Pinterest.
- Pinterest Pins API — Преобразуйте URL публичных пинов в нормализованный контент, автора, медиа, таксономию, метки времени и видимые метрики.
- Pinterest User Pins API — Находите публичные пины по URL профилей с лимитом на профиль: нормализованный контент, автор, медиа, метки времени и видимые метрики.
- Pinterest Search API — Ищите публичные пины по текстовому запросу с лимитом результатов и получайте нормализованный контент, автора, медиа, таксономию, метки времени и видимые метрики.
- Pinterest User Boards API — Получайте доски профилей Pinterest по URL профилей: названия, описания, обложки, даты создания и число пинов, подписчиков, разделов и соавторов.
- Pinterest Board Pins API — Собирайте пины доски Pinterest по ее URL в порядке доски: текст пина, сохранивший аккаунт, изображения в полном размере и ссылки на пины.
- Pinterest Topic API — Читайте страницы идей Pinterest по URL: месячное число поисков темы, время его обновления и предложенные более узкие темы.