pinterest/
user-boards

Получайте доски профилей Pinterest по их URL: название доски, описание, обложка, владелец, дата создания и число пинов, подписчиков, разделов и соавторов.

Pinterest User Boards API

URL профиля на входе
До 500 досок на профиль
Число пинов и подписчиков
Признак совместной доски
0,5 кредита за результат
Готово
Готово

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

README

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

Pinterest User Boards

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

Возможности Pinterest User Boards API

  • Все доски профиляПередайте в urls одну или несколько ссылок на профили Pinterest, и каждая доска этих профилей вернется отдельной строкой со своими id и url.
  • Размер и аудитория каждой доскиmetrics.pins_count показывает, сколько сохранено на доску, а metrics.followers_count — сколько людей на нее подписаны, что отличает просто объемный архив от коллекции с реальной аудиторией.
  • Групповые доски и разделыis_collaborative отмечает доски, куда пины могут добавлять другие аккаунты, metrics.collaborators_count показывает, сколько их, а metrics.sections_count — насколько подробно доска разбита на разделы.
  • Название, описание, обложка и дата созданияname, text и cover_url сразу показывают, о чем доска, а published_at фиксирует, когда она создана, то есть когда эта тема появилась у аккаунта.
  • До 500 досок на профильresults_limit применяется к каждому профилю отдельно, по умолчанию равен 25 и принимает до 500, поэтому аккаунты с сотнями досок можно выгрузить полностью.

Параметры Pinterest User Boards API

ПараметрыОбязательныйОписание
urlsОбязательныйСсылки на профили Pinterest с одним именем пользователя в пути, например https://www.pinterest.com/marthastewart/; подходят и страновые домены вроде pinterest.co.uk или de.pinterest.com.
results_limitНеобязательныйМаксимальное число досок для каждого профиля, целое число от 1 до 500. По умолчанию 25.

Как использовать Pinterest User Boards API

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

  1. Отправьте ссылки на профили и необязательный results_limit в POST /v1/pinterest/user-boards и сохраните task_id из ответа.
  2. Вызывайте GET /v1/tasks/{task_id} каждые несколько секунд, пока status не станет succeeded.
  3. Читайте доски из results.items; пока has_more равно true, запрашивайте следующую страницу с results.next_cursor.
curl -X POST "https://api.socq.ai/v1/pinterest/user-boards" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/marthastewart/"],"results_limit":25}'

# Each board returned costs 0.5 credits.

Сценарии использования Pinterest User Boards API

  • Аудит тем конкурента в Pinterest: Сопоставляйте name и text досок с pins_count, чтобы увидеть, какие темы бренд пополняет постоянно, и с followers_count, чтобы понять, на какие коллекции подписываются люди.
  • Отбор авторов по нише: Соберите доски кандидатов и сопоставьте названия и описания досок с вашей темой, оставив аккаунты, которые ведут ее сразу на нескольких досках.
  • Поиск групповых досок для участия: Оставьте строки, где is_collaborative равно true, и соотнесите collaborators_count с followers_count, чтобы выбрать совместные доски с аудиторией.
  • Отслеживание роста коллекций: Регулярно собирайте те же профили и сравнивайте pins_count и followers_count по id доски, чтобы видеть, какие доски набирают пины или подписчиков.

Практические советы по Pinterest User Boards API

  • Обрезайте ссылки на доски и пины до корня профиля перед отправкой: urls принимает https://www.pinterest.com/{username}/, а ссылки на доски нужны для Pinterest Board Pins API.
  • Увеличьте results_limit выше 25 по умолчанию, если досок у профиля больше; лимит действует на каждый профиль, а оплачиваются только реально возвращенные доски.
  • Группируйте строки по author.username, если одна задача охватывает несколько профилей: каждая доска содержит данные аккаунта-владельца.
  • Передавайте url каждой доски в Pinterest Board Pins API, чтобы получить ее пины, и по metrics.pins_count решайте, какой results_limit задать для этого эндпоинта.

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

  • Pinterest Pins API — Преобразуйте URL публичных пинов в нормализованный контент, автора, медиа, таксономию, метки времени и видимые метрики.
  • Pinterest User Pins API — Находите публичные пины по URL профилей с лимитом на профиль: нормализованный контент, автор, медиа, метки времени и видимые метрики.
  • Pinterest Profiles API — Собирайте по URL профилей публичные данные аккаунта, описание, изображение, сайт, видимые счетчики и контекст сбора.
  • Pinterest Search API — Ищите публичные пины по текстовому запросу с лимитом результатов и получайте нормализованный контент, автора, медиа, таксономию, метки времени и видимые метрики.
  • Pinterest Board Pins API — Собирайте пины доски Pinterest по ее URL в порядке доски: текст пина, сохранивший аккаунт, изображения в полном размере и ссылки на пины.
  • Pinterest Topic API — Читайте страницы идей Pinterest по URL: месячное число поисков темы, время его обновления и предложенные более узкие темы.

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

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

Pinterest User Boards API — FAQ

Pinterest User Boards API — это программный интерфейс для получения списка досок публичных профилей Pinterest по URL этих профилей. Он возвращает название, описание, обложку, владельца, дату создания, признак совместной доски и число пинов, подписчиков, разделов и соавторов каждой доски.

Укажите ссылку на профиль в urls и задайте results_limit не меньше числа его досок, максимум 500. Каждая доска вернется отдельной строкой с названием, url и счетчиками.

Каждая строка описывает саму доску, а число ее пинов указано в metrics.pins_count. Чтобы прочитать пины, отправьте url доски в Pinterest Board Pins API.

Совместная доска, которую часто называют групповой, позволяет добавлять пины не только владельцу. Для таких досок is_collaborative равно true, а metrics.collaborators_count содержит число соавторов.

Каждая доска стоит 0,5 кредита, поэтому три профиля с лимитом по умолчанию 25 обойдутся максимум в 37,5 кредита. Если у профиля меньше досок, чем лимит, оплачиваются только возвращенные.