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
Отправьте ссылки на доски, дождитесь завершения задачи и читайте пины страница за страницей.
- Отправьте ссылки на доски в urls, а также results_limit, если нужно больше 50 пинов на доску, методом POST на /v1/pinterest/board.
- Опрашивайте GET /v1/tasks/{task_id} с полученным task_id, пока задача не завершится успешно.
- Берите пины из 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 запрашивайте только для изображений, которые оставляете, — это экономит трафик на досках с сотнями пинов.
Связанные API
Помимо 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: месячное число поисков темы, время его обновления и предложенные более узкие темы.