pinterest/
user-pins

Находите публичные пины Pinterest по одному или нескольким URL профилей и получайте идентификаторы пинов, текст, данные автора, медиа, видимую вовлеченность и контекст источника в виде нормализованных записей.

Pinterest User Pins API

URL профиля на входе
Лимит на каждый профиль
Нормализованные публичные пины
0,5 кредита за результат
Готово
Готово

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

README

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

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 с лимитом результатов на профиль, отслеживайте асинхронную задачу и читайте нормализованные пины с курсорной пагинацией.

  1. Подготовьте один или несколько URL публичных профилей Pinterest с одним сегментом пути профиля.
  2. Отправьте urls и необязательный results_limit методом POST на /v1/pinterest/user-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/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, категории, хештеги, источник, данные автора и отдельные метрики необязательными и не делайте выводов о том, создан пин или сохранен, если классификация не возвращена.

Помимо 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: месячное число поисков темы, время его обновления и предложенные более узкие темы.

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

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

Pinterest User Pins API — FAQ

Pinterest User Pins API находит публичные записи пинов по переданным URL профилей Pinterest. Он возвращает нормализованные идентификаторы пинов, текст, авторов, медиа, видимую вовлеченность, метки времени и контекст источника, а не записи профилей.

Передайте URL с HTTP или HTTPS на поддерживаемом домене Pinterest, путь которого содержит ровно один незарезервированный сегмент профиля, например /example/. Пути пинов, страницы поиска, страницы ideas, более глубокие пути и ссылки pin.it отклоняются.

Записи могут содержать ID пина, URL, заголовок, текст, публичные данные автора, ссылки на изображения или видео, видимое число лайков, комментариев и подписчиков, created_at, collected_at, а также поля классификации и поиска в extra. Необязательные значения источника могут быть null или пустыми.

results_limit по умолчанию равен 100 и принимает целые числа от 1 до 2 000. Он применяется к каждому URL профиля, поэтому два URL с results_limit 50 запрашивают до 100 пинов.

В нормализованном ответе нет стабильной классификации «создан или сохранен». Считайте результаты публичными пинами, найденными по переданному URL профиля, и не делайте выводов о типе принадлежности.

Нет. Этот эндпоинт принимает только URL профилей и results_limit; параметров URL доски, идентификатора доски или фильтра по доске нет.

Каждая возвращенная запись пина стоит 0,5 кредита SocQ. Оценка рассчитывается как число urls, умноженное на results_limit, а пустой набор результатов не оплачивается.