pinterest/
pins

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

Pinterest Pins API

URL пина на входе
Автор и медиа
Снимок видимых метрик
0,5 кредита за результат
Готово
Готово

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

README

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

Pinterest Pins

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

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

  • Прямые и короткие URL пиновОбрабатывает один или несколько публичных URL Pinterest вида /pin/{id} или коротких ссылок pin.it, ограничивая сбор только переданными пинами.
  • Связанные поля контента и автораВозвращает заголовок и текст пина вместе с исходным URL, публичными данными автора, URL профиля и нормализованными ссылками на изображение или видео.
  • Видимые метрики со временем наблюденияСохраняет доступное число лайков и комментариев, а также число подписчиков автора вместе с collected_at, чтобы у изменчивых публичных значений было четкое время снимка.
  • Классификация пинаСохраняет доступные post_type, категории и хештеги в extra для анализа форматов и тем, не смешивая их с текстом пина.

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

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный список публичных URL Pinterest вида /pin/{id} или коротких ссылок pin.it. Другие пути Pinterest и хосты, не относящиеся к Pinterest, отклоняются.

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

Отправьте нужные публичные пины, отслеживайте асинхронную задачу и читайте нормализованные записи пинов с курсорной пагинацией.

  1. Подготовьте один или несколько публичных URL Pinterest вида /pin/{id} или коротких ссылок pin.it.
  2. Отправьте ссылки в urls на /v1/pinterest/pins и сохраните 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/pins" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/pin/123456789/"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • Архивирование выбранных пинов: Сохраняйте ID пинов, исходные URL, заголовки, текст, поля автора, ссылки на медиа и время публикации для заданного списка URL.
  • Анализ креативов и тем: Используйте тип медиа, post_type, категории, хештеги, заголовки и текст, чтобы сравнивать форматы и темы выбранных пинов.
  • Сравнение сигналов на момент сбора: Сравнивайте видимое число лайков и комментариев вместе с числом подписчиков автора, привязывая каждое наблюдение к collected_at.

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

  • Используйте для каждого элемента публичный URL вида /pin/{id} или ссылку pin.it: профили, поиск, ideas и другие пути Pinterest не соответствуют правилу входных данных этого эндпоинта.
  • Убирайте дубли возвращенных значений id, если прямая и короткая ссылки могут вести на один и тот же пин.
  • Считайте медиа, created_at, категории, хештеги, post_type и отдельные метрики необязательными полями: публичный пин может показывать не все значения.
  • Храните collected_at рядом с видимыми метриками, чтобы последующие запуски можно было интерпретировать как отдельные снимки на момент сбора.

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

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

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

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

Pinterest Pins API — FAQ

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

Передайте URL с HTTP или HTTPS на домене Pinterest, путь которого начинается с /pin/{id}, или короткую ссылку pin.it. Профили, поиск, ideas и другие пути отклоняются.

Нет. Эндпоинт обрабатывает только поддерживаемые публичные ссылки на пины из urls и не разворачивает профиль автора в ленту.

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

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

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