pinterest/
profiles

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

Pinterest Profiles API

URL профиля на входе
Идентичность и сайт
Видимые метрики аккаунта
0,6 кредита за результат
Готово
Готово

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

README

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

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 публичных профилей, отслеживайте асинхронную задачу и читайте нормализованные записи профилей с курсорной пагинацией.

  1. Подготовьте один или несколько URL публичных профилей Pinterest, путь которых содержит один сегмент с именем пользователя.
  2. Отправьте ссылки в urls на /v1/pinterest/profiles и сохраните task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока обработка не завершится успешно или с ошибкой.
  4. Читайте 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, если вам нужны записи пинов из профиля: этот эндпоинт возвращает метаданные и счетчики профиля, а не доски, пины или списки аудитории.

Помимо 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: месячное число поисков темы, время его обновления и предложенные более узкие темы.

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

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

Pinterest Profiles API — FAQ

Pinterest Profiles API получает публичные метаданные профиля по одному или нескольким поддерживаемым URL профилей Pinterest. Он возвращает нормализованные данные об идентичности, описание профиля, изображение профиля, сайт, видимые счетчики аккаунта и контекст сбора.

Передайте полный URL с HTTP или HTTPS на домене Pinterest, путь которого содержит один незарезервированный сегмент с именем пользователя. URL пинов, ссылки pin.it, страницы поиска и зарезервированные пути, например /ideas/ или /today/, отклоняются.

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

Нет. Он возвращает метаданные профиля и видимые агрегированные счетчики, а не записи досок, записи пинов или участников списков подписчиков и подписок; если нужны пины, найденные по URL профиля, используйте Pinterest User Pins API.

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

Каждая запись профиля в завершенном результате стоит 0,6 кредита SocQ. Пустой набор результатов не оплачивается.