Pinterest User Boards
Доска Pinterest — это именованная коллекция сохраненных пинов с описанием, обложкой и датой создания, а также числом пинов, подписчиков, разделов и соавторов и признаком того, могут ли добавлять в нее пины другие аккаунты. Если просмотреть доски всего профиля, видно, какие темы аккаунт подбирает активнее всего, какие коллекции собирают собственных подписчиков и где он открыт для совместного наполнения.
Возможности Pinterest User Boards API
- Все доски профиляПередайте в urls одну или несколько ссылок на профили Pinterest, и каждая доска этих профилей вернется отдельной строкой со своими id и url.
- Размер и аудитория каждой доскиmetrics.pins_count показывает, сколько сохранено на доску, а metrics.followers_count — сколько людей на нее подписаны, что отличает просто объемный архив от коллекции с реальной аудиторией.
- Групповые доски и разделыis_collaborative отмечает доски, куда пины могут добавлять другие аккаунты, metrics.collaborators_count показывает, сколько их, а metrics.sections_count — насколько подробно доска разбита на разделы.
- Название, описание, обложка и дата созданияname, text и cover_url сразу показывают, о чем доска, а published_at фиксирует, когда она создана, то есть когда эта тема появилась у аккаунта.
- До 500 досок на профильresults_limit применяется к каждому профилю отдельно, по умолчанию равен 25 и принимает до 500, поэтому аккаунты с сотнями досок можно выгрузить полностью.
Параметры Pinterest User Boards API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Ссылки на профили Pinterest с одним именем пользователя в пути, например https://www.pinterest.com/marthastewart/; подходят и страновые домены вроде pinterest.co.uk или de.pinterest.com. |
results_limit | Необязательный | Максимальное число досок для каждого профиля, целое число от 1 до 500. По умолчанию 25. |
Как использовать Pinterest User Boards API
Отправьте ссылки на профили, дождитесь завершения задачи и пройдите по страницам — по одной строке на доску.
- Отправьте ссылки на профили и необязательный results_limit в POST /v1/pinterest/user-boards и сохраните task_id из ответа.
- Вызывайте GET /v1/tasks/{task_id} каждые несколько секунд, пока status не станет succeeded.
- Читайте доски из results.items; пока has_more равно true, запрашивайте следующую страницу с results.next_cursor.
curl -X POST "https://api.socq.ai/v1/pinterest/user-boards" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/marthastewart/"],"results_limit":25}'
# Each board returned costs 0.5 credits.Сценарии использования Pinterest User Boards API
- Аудит тем конкурента в Pinterest: Сопоставляйте name и text досок с pins_count, чтобы увидеть, какие темы бренд пополняет постоянно, и с followers_count, чтобы понять, на какие коллекции подписываются люди.
- Отбор авторов по нише: Соберите доски кандидатов и сопоставьте названия и описания досок с вашей темой, оставив аккаунты, которые ведут ее сразу на нескольких досках.
- Поиск групповых досок для участия: Оставьте строки, где is_collaborative равно true, и соотнесите collaborators_count с followers_count, чтобы выбрать совместные доски с аудиторией.
- Отслеживание роста коллекций: Регулярно собирайте те же профили и сравнивайте pins_count и followers_count по id доски, чтобы видеть, какие доски набирают пины или подписчиков.
Практические советы по Pinterest User Boards API
- Обрезайте ссылки на доски и пины до корня профиля перед отправкой: urls принимает https://www.pinterest.com/{username}/, а ссылки на доски нужны для Pinterest Board Pins API.
- Увеличьте results_limit выше 25 по умолчанию, если досок у профиля больше; лимит действует на каждый профиль, а оплачиваются только реально возвращенные доски.
- Группируйте строки по author.username, если одна задача охватывает несколько профилей: каждая доска содержит данные аккаунта-владельца.
- Передавайте url каждой доски в Pinterest Board Pins API, чтобы получить ее пины, и по metrics.pins_count решайте, какой results_limit задать для этого эндпоинта.
Связанные API
Помимо Pinterest User Boards API, используйте эти API, когда нужен другой тип публичных данных Pinterest.
- Pinterest Pins API — Преобразуйте URL публичных пинов в нормализованный контент, автора, медиа, таксономию, метки времени и видимые метрики.
- Pinterest User Pins API — Находите публичные пины по URL профилей с лимитом на профиль: нормализованный контент, автор, медиа, метки времени и видимые метрики.
- Pinterest Profiles API — Собирайте по URL профилей публичные данные аккаунта, описание, изображение, сайт, видимые счетчики и контекст сбора.
- Pinterest Search API — Ищите публичные пины по текстовому запросу с лимитом результатов и получайте нормализованный контент, автора, медиа, таксономию, метки времени и видимые метрики.
- Pinterest Board Pins API — Собирайте пины доски Pinterest по ее URL в порядке доски: текст пина, сохранивший аккаунт, изображения в полном размере и ссылки на пины.
- Pinterest Topic API — Читайте страницы идей Pinterest по URL: месячное число поисков темы, время его обновления и предложенные более узкие темы.