Pinterest User Pins
Пины пользователя Pinterest — это публичные визуальные публикации, связанные с профилем и представленные заголовками, описаниями, данными автора, ссылками на медиа, категориями, хештегами, метками времени и видимой вовлеченностью. Эти поля контента и наблюдения помогают архивировать коллекции профилей, исследовать визуальные темы, указывать источник и сравнивать данные на момент сбора.
Возможности Pinterest User Pins API
- Поиск пинов по профилюПринимает один или несколько URL публичных профилей Pinterest и возвращает записи пинов, связанных с каждым переданным профилем, а не метаданные профиля.
- Глубина сбора для каждого профиляПрименяет results_limit отдельно к каждому URL профиля; по умолчанию 100, допустимый диапазон — от 1 до 2 000.
- Нормализованные записи пинов, авторов и медиаВозвращает идентификаторы пинов, URL, заголовки, текст, публичные поля автора и ссылки на изображения или видео в единой структуре результата.
- Вовлеченность и контекст источникаСохраняет видимое число лайков, комментариев и подписчиков автора вместе со временем публикации, collected_at, полями классификации и discovery_input, если они доступны.
Параметры Pinterest User Pins API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный список URL публичных профилей Pinterest с HTTP или HTTPS и ровно одним незарезервированным сегментом пути; URL пинов, поиска, ideas и pin.it отклоняются. |
results_limit | Необязательный | Максимальное число пинов, запрашиваемых для каждого URL профиля; по умолчанию 100, допускаются целые числа от 1 до 2 000. |
Как использовать Pinterest User Pins API
Отправьте URL публичных профилей Pinterest с лимитом результатов на профиль, отслеживайте асинхронную задачу и читайте нормализованные пины с курсорной пагинацией.
- Подготовьте один или несколько URL публичных профилей Pinterest с одним сегментом пути профиля.
- Отправьте urls и необязательный results_limit методом POST на /v1/pinterest/user-pins и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items и запрашивайте возвращенный next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/pinterest/user-pins" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/example/"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования Pinterest User Pins API
- Архивирование пинов публичных профилей: Сохраняйте ID пинов, исходные URL, заголовки, текст, поля автора, ссылки на медиа, метки времени и discovery_input для заданных URL профилей.
- Исследование визуала и таксономии: Используйте тип медиа, post_type, категории, хештеги, заголовки и текст, чтобы изучать повторяющиеся форматы и темы в выбранных публичных профилях.
- Сравнение сигналов между профилями: Сравнивайте видимое число лайков и комментариев вместе с числом подписчиков автора в коллекциях разных профилей, привязывая каждое наблюдение к collected_at.
Практические советы по Pinterest User Pins API
- Передавайте URL публичного профиля Pinterest ровно с одним сегментом пути профиля: ссылки на пины, короткие ссылки pin.it, страницы поиска и более глубокие пути не проходят проверку профиля.
- Рассчитывайте запрошенную глубину и предварительную оценку кредитов как число urls, умноженное на results_limit, поскольку лимит применяется к каждому профилю отдельно.
- Сохраняйте discovery_input и collected_at с каждым пином, чтобы в последующих датасетах оставались переданный профиль и время наблюдения.
- Считайте медиа, created_at, категории, хештеги, источник, данные автора и отдельные метрики необязательными и не делайте выводов о том, создан пин или сохранен, если классификация не возвращена.
Связанные API
Помимо Pinterest User Pins API, используйте эти API, когда нужен другой тип публичных данных Pinterest.
- Pinterest 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: месячное число поисков темы, время его обновления и предложенные более узкие темы.