pinterest/
board

Собирайте пины досок Pinterest по URL досок в порядке доски: текст пина, сохранивший его аккаунт, изображение в полном размере и миниатюра с размерами, а также ссылка на пин.

Pinterest Board Pins API

URL доски на входе
Пины в порядке доски
URL изображений в полном размере
До 1 000 пинов на доску
0,5 кредита за результат
Готово
Готово

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

README

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

Pinterest Board Pins

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

Возможности Pinterest Board Pins API

  • Пины в порядке доскиСтроки идут в той последовательности, которую показывает сама доска, поэтому коллекция читается так, как ее выстроил куратор.
  • Оригинал и миниатюраmedia.url указывает на изображение в полном размере, а media.thumbnail_url — на небольшое превью, с шириной и высотой в пикселях для каждого файла.
  • Кто сохранил пин и что в нем написаноauthor указывает аккаунт, сохранивший каждый пин, с именем пользователя, отображаемым именем, ссылкой на профиль и аватаром, а text содержит заголовок или описание пина.
  • Ссылка на каждый пинurl — собственная страница пина, построенная по его id, так что любое изображение из набора можно найти на Pinterest.
  • До 1 000 пинов с каждой доскиresults_limit считается на каждую доску, по умолчанию равен 50 и принимает до 1 000, а в urls можно передать несколько досок сразу.

Параметры Pinterest Board Pins API

ПараметрыОбязательныйОписание
urlsОбязательныйСсылки на доски Pinterest в формате /{username}/{board}/, например https://www.pinterest.com/lizmrodgers/moms-night/.
results_limitНеобязательныйМаксимальное число пинов для каждой доски, целое число от 1 до 1 000. По умолчанию 50.

Как использовать Pinterest Board Pins API

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

  1. Отправьте ссылки на доски в urls, а также results_limit, если нужно больше 50 пинов на доску, методом POST на /v1/pinterest/board.
  2. Опрашивайте GET /v1/tasks/{task_id} с полученным task_id, пока задача не завершится успешно.
  3. Берите пины из results.items и продолжайте запросы с results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/pinterest/board" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/lizmrodgers/moms-night/"],"results_limit":50}'

# 0.5 credits per pin; boards that do not exist return no pins.

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

  • Скачивание изображений доски: Сохраняйте каждый media.url с доски, чтобы собрать локальную библиотеку оригинальных файлов, а по width и height разделяйте вертикальные и горизонтальные снимки.
  • Датасет изображений с подписями: Объединяйте каждое изображение с text пина и доской, с которой оно получено, чтобы собрать размеченные примеры для дизайн-исследований или обучения моделей.
  • Наблюдение за сезонной доской конкурента: Собирайте одну и ту же доску каждую неделю и сравнивайте id пинов с прошлым запуском, чтобы точно видеть, что добавлено.
  • Указание источников в мудборде: Храните author.username и url пина рядом с каждым изображением, чтобы любую картинку в презентации можно было подписать и открыть снова.

Практические советы по Pinterest Board Pins API

  • Используйте собственную ссылку доски из двух сегментов: вкладки профиля вроде /{username}/_saved/ или /{username}/pins/, более глубокие пути разделов и короткие ссылки pin.it отклоняются, поэтому откройте доску и скопируйте ее адрес.
  • Сначала проверьте metrics.pins_count доски через Pinterest User Boards API и задайте results_limit под него, чтобы большая доска не обрезалась на 50 пинах по умолчанию.
  • Загружайте thumbnail_url для сеток и превью, а media.url запрашивайте только для изображений, которые оставляете, — это экономит трафик на досках с сотнями пинов.

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

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

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

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

Pinterest Board Pins API — FAQ

Pinterest Board Pins API — это программный интерфейс для сбора пинов, сохраненных на доске Pinterest, по URL этой доски. Он возвращает текст каждого пина, сохранивший его аккаунт, изображение в полном размере и миниатюру с размерами, а также ссылку на пин в том порядке, в каком их показывает доска.

Каждый пин содержит media.url — адрес изображения в полном размере, которое можно скачать любым HTTP-клиентом. Задайте results_limit по числу пинов доски, до 1 000, чтобы охватить ее целиком.

author — это аккаунт, который сохранил пин на доску, с именем пользователя, отображаемым именем, url профиля и аватаром.

Каждый пин стоит 0,5 кредита, поэтому доска с 50 пинами по умолчанию стоит 25 кредитов, а доска из 400 пинов — 200 кредитов.