Ко всем API
Публичные данные Pinterest

Pinterest Public Data API

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

Доступные API Pinterest

Используйте Profiles для данных аккаунта, Pins для известного пина, User Pins для контента выбранных профилей или Search для поиска пинов по ключевым словам.

Какие данные Pinterest можно получить?

SocQ возвращает нормализованные публичные записи аккаунтов и пинов с идентификационными данными, контентом, медиа, классификацией, контекстом поиска, вовлеченностью и временем сбора.

Публичные данные профиля

Получайте ID профилей, имена пользователей, отображаемые имена, описания профиля, изображения, привязанные сайты, сведения о стране и видимые счетчики аккаунта.

Контент и медиа пинов

Получайте идентификационные данные пина, заголовок, текст, сведения об авторе, ссылки на медиа, время публикации и видимые метрики, если они доступны.

Коллекции пинов автора

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

Темы и классификация

Ищите пины по ключевым словам и сохраняйте доступные тип публикации, категории, хештеги, сведения об источнике и поисковый запрос.

SocQ vs Pinterest API

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

ВозможностьSocQPinterest API
Основное назначениеСбор публичных профилей, пинов, пинов пользователей и результатов поискаУправление авторизованным контентом, рекламой, аналитикой и каталогами
OAuth клиентаAPI-ключ SocQ; OAuth Pinterest от клиента не нуженПриложение Pinterest, токен доступа и нужные scopes
Входные данныеURL публичного профиля или пина либо текстовый запросКонтекст авторизованного аккаунта и ID ресурсов Pinterest
Создание и управление пинамиНе поддерживаетсяПоддерживается от имени авторизованного пользователя с правами на запись
Формат ответаНормализованные записи SocQНативные объекты Pinterest API

Как работает API Pinterest

Все четыре API Pinterest используют один и тот же процесс: асинхронная задача и результаты с пагинацией.

  1. 1. Отправьте входные данные

    Отправьте URL профилей, URL пинов или поисковый запрос в нужный API и сохраните возвращенный task_id.

  2. 2. Отслеживайте задачу

    Опрашивайте /v1/tasks/{task_id}, пока обработка не завершится.

  3. 3. Получите результаты

    Читайте data.results.items и используйте next_cursor, пока has_more равно true.

Поиск публичных пинов по ключевым словам

Пройдите аутентификацию с API-ключом SocQ и отправьте текстовый запрос. Profiles, Pins и User Pins работают по той же схеме задач.

curl -X POST "https://api.socq.ai/v1/pinterest/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"home office ideas","results_limit":100}'

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

Типичные сценарии использования API Pinterest

Исследование авторов и профилей

Дополняйте известные URL профилей публичными идентификационными данными, описанием профиля, сайтом, сведениями о стране, видимыми счетчиками и временем сбора.

Анализ известных пинов

Превращайте выбранные URL пинов в данные о контенте, авторе, медиа, таксономии, временные метки, видимые метрики и ссылки на источник.

Мониторинг контента авторов

Собирайте ограниченные наборы пинов выбранных профилей и сравнивайте контент и снимки аккаунтов на момент сбора.

Исследование визуальных тем и трендов

Ищите по заданным ключевым словам, чтобы собирать структурированные датасеты пинов с контекстом автора, медиа, классификации и поиска.

Ограничения и политика публичных данных

Результаты Pinterest — это публичные записи на момент сбора. Эти API не дают доступа к приватному контенту и не создают, не редактируют, не сохраняют и не управляют профилями и пинами.

  • Profiles требует URL профиля с одним сегментом пути — именем пользователя. Он возвращает данные аккаунта, а не доски, пины или списки участников аудитории.
  • Pins требует URL известного публичного пина вида /pin/{id} или ссылку pin.it и не разворачивает профиль в коллекцию пинов.
  • User Pins требует URL публичных профилей. Значение results_limit по умолчанию равно 100, допускает от 1 до 2 000 и применяется к каждому профилю отдельно.
  • Search требует один текстовый запрос. Значение results_limit по умолчанию равно 100 и допускает от 1 до 2 000; сортировка и дополнительные фильтры недоступны.
  • Необязательные поля идентификации, контента, медиа, классификации, источника, временных меток и метрик могут быть null или пустыми, если публичный источник их не показывает.
  • API работают только на чтение и не создают, не редактируют, не сохраняют и не управляют профилями, досками или пинами Pinterest.

Частые вопросы об API Pinterest

Что такое API Pinterest?

API Pinterest — это набор эндпоинтов SocQ для получения публичных данных профилей, разбора известных пинов, сбора пинов выбранных профилей и поиска публичных пинов по ключевым словам.

Какой API Pinterest выбрать?

Используйте Profiles для данных аккаунта, Pins для известных ссылок /pin/{id} или pin.it, User Pins для ограниченной коллекции по URL профилей и Search для поиска по ключевым словам.

Возвращают ли Profiles и User Pins одни и те же данные?

Нет. Profiles возвращает метаданные аккаунта и агрегированные счетчики, а User Pins — нормализованные записи пинов, найденные по переданным URL профилей.

Как работает лимит результатов в User Pins?

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

Почему поля могут быть null или пустыми?

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

Сколько стоит сбор данных Pinterest?

Каждый возвращенный профиль или пин из Search стоит 0,6 кредита, а каждый возвращенный пин из Pins или User Pins — 0,5 кредита. За пустые наборы результатов плата за результаты не взимается.

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

Threads API

Получайте публичные профили Threads, разбирайте известные публикации или собирайте публикации выбранных профилей с нормализованными полями идентификации, контента, медиа, вовлеченности и временных меток.

Bluesky API

Получайте публичные профили Bluesky, данные по известным URL публикаций или одну страницу публикаций аккаунта с нормализованными полями идентичности, контента, медиа, меток времени и видимой вовлеченности.

Snapchat API

Получайте известный публичный ролик Snapchat Spotlight в виде нормализованной записи с доступными полями автора, подписи, медиа, аудио, временных меток, длительности и вовлеченности.

Twitch API

Превращайте известное публичное имя пользователя Twitch в нормализованный профиль, собирайте его публичные видео или получайте отдельный клип вместе со скачиваемым видео для исследования авторов, обогащения каталогов, сравнения и мониторинга снимков.

Rednote API

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

Kwai API

Получайте публичные профили Kwai, одну страницу публикаций аккаунта или одну известную публикацию с нормализованными данными об идентичности, контентом, медиа, метками времени и видимой вовлеченностью.