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
Отправьте нужные публичные пины, отслеживайте асинхронную задачу и читайте нормализованные записи пинов с курсорной пагинацией.
- Подготовьте один или несколько публичных URL Pinterest вида /pin/{id} или коротких ссылок pin.it.
- Отправьте ссылки в urls на /v1/pinterest/pins и сохраните task_id.
- Опрашивайте /v1/tasks/{task_id}, пока обработка не завершится успешно или с ошибкой.
- Читайте 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 рядом с видимыми метриками, чтобы последующие запуски можно было интерпретировать как отдельные снимки на момент сбора.
Связанные API
Помимо 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: месячное число поисков темы, время его обновления и предложенные более узкие темы.