Первые эндпоинты SocQ для Pinterest читали профили, отдельные пины, пины пользователя и результаты поиска. 2026-11-17 заработали еще три, и они работают на другом уровне: доски и темы. Доски показывают, как бренд или автор организует идеи; темы показывают, сколько людей ищут идею и какие более узкие идеи к ней относятся.
В этом руководстве объясняется, что возвращает каждый новый эндпоинт, как выглядит запрос, сколько он стоит и как три эндпоинта сочетаются друг с другом. Если вы в целом сравниваете поставщиков данных Pinterest, см. статью 7 лучших API для парсинга Pinterest.
Коротко: отправьте URL профилей, досок или страниц идей Pinterest в
urlsнаPOST /v1/pinterest/user-boards,/boardили/topicс заголовкомAuthorization: Bearer $SOCQ_API_KEY. ОпрашивайтеGET /v1/tasks/{task_id}, покаstatusне станетsucceeded, затем читайтеdata.results.items. Все три стоят 0.5 кредита за результат ($0.0025 при цене $0.005 за кредит), без базовой платы.
Три новых эндпоинта Pinterest
| Эндпоинт | Что возвращает | Вход | Цена |
|---|---|---|---|
| User Boards | Публичные доски профиля с названием, описанием, обложкой, владельцем, датой создания и счетчиками пинов, подписчиков, разделов и соавторов | URL профилей | 0.5 кредита ($0.0025) за доску |
| Board Pins | Пины на доске в порядке доски, с описанием, сохранившим аккаунтом, полноразмерным изображением и ссылкой на пин | URL досок | 0.5 кредита ($0.0025) за пин |
| Topic | Месячное число поисков по теме и более узкие темы, которые предлагает Pinterest | URL страниц идей | 0.5 кредита ($0.0025) за тему |
Pinterest User Boards: аудит профиля
Pinterest User Boards API перечисляет все публичные доски профиля Pinterest. Каждая доска возвращается с названием, описанием, обложкой, владельцем, датой создания и счетчиками пинов, подписчиков, разделов и соавторов, а также флагом is_collaborative для досок, на которые могут добавлять пины другие аккаунты. Это первый вызов, когда вы проводите аудит Pinterest конкурента или отбираете авторов по теме: счетчики показывают, в какие темы аккаунт вкладывается и на какие коллекции люди действительно подписываются.
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
}'
Используйте URL профилей вида https://www.pinterest.com/username/. results_limit применяется к каждому профилю, по умолчанию равен 25, допустимы значения от 1 до 500. Счетчики доски находятся в metrics: pins_count, followers_count, sections_count и collaborators_count. См. документацию User Boards.
Pinterest Board Pins: что хранится на доске
Pinterest Board Pins API возвращает пины внутри доски в том порядке, в каком их показывает доска. Каждый пин содержит заголовок или описание, аккаунт, который его сохранил, полноразмерное изображение (с миниатюрой и размерами в media) и URL пина. Направьте его на тематическую доску в вашей нише, чтобы собрать референсы, отслеживать, что конкурент добавляет на сезонную доску, или за один проход собрать датасет для мудборда.
curl -X POST "https://api.socq.ai/v1/pinterest/board" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.pinterest.com/lizmrodgers/moms-night/"],
"results_limit": 50
}'
Используйте URL досок в форме /{username}/{board}/. results_limit применяется к каждой доске, по умолчанию равен 50, допустимы значения от 1 до 1,000. См. документацию Board Pins.
Pinterest Topic: исследование ключевых слов для Pinterest
Pinterest Topic API оценивает тему до того, как вы начнете создавать для нее контент. Для каждой страницы идей вы получаете месячное число поисков, которое сообщает Pinterest (search_count), и более узкие темы, которые он предлагает под ней (related_topics, каждая с названием, короткой меткой и собственным URL страницы идей), например стили, поводы и материалы, которые люди сочетают с основной идеей.
curl -X POST "https://api.socq.ai/v1/pinterest/topic" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.pinterest.com/ideas/home-decor/935249274030/"]
}'
Используйте URL страниц идей в форме /ideas/{topic}/{id}/. Каждая тема возвращает одну строку. Поскольку у каждой более узкой темы есть собственный URL, эти URL можно снова передать в тот же эндпоинт и сравнить спрос по направлениям длинного хвоста. См. документацию Topic.
Как три эндпоинта сочетаются друг с другом
Типичное исследование конкурента или ниши связывает их в цепочку:
- User Boards для профиля конкурента, чтобы увидеть, у каких досок больше всего подписчиков и пинов.
- Board Pins для важных досок, чтобы собрать изображения и описания внутри них.
- Topic для страниц идей по этим темам, чтобы проверить месячный поисковый спрос и найти более узкие направления.
Для отдельных пинов, собственных пинов пользователя или результатов поиска по ключевым словам используйте ранее выпущенные эндпоинты Pins, User Pins и Search. Все эндпоинты Pinterest перечислены на странице платформы Pinterest.
Аутентификация и асинхронные задачи
Каждый запрос содержит ваш API-ключ и тип содержимого JSON:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Каждый вызов отправки запускает фоновую задачу:
submit -> task_id -> queued -> running -> succeeded
\-> failed
Ответ на отправку возвращает data.task_id и data.status. Опрашивайте задачу с тем же ключом:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Пока задача находится в состоянии queued, running или failed, ответ содержит только метаданные задачи; при failed читайте error_message. Когда задача в состоянии succeeded, тот же ответ содержит первую страницу нормализованных записей в data.results.items. По умолчанию limit равен 50, максимум 500. Если has_more равно true, передайте results.next_cursor как cursor, чтобы прочитать следующую страницу. fields принимает до 50 полей или путей через точку, разделенных запятыми, если вам нужны лишь несколько столбцов, например name,metrics.followers_count для досок.
Тайм-аут на стороне клиента не отменяет задачу, поэтому продолжайте с тем же task_id, а не отправляйте и не оплачивайте дубликат. Чтобы обойтись без опроса, добавьте callback_url в тело запроса; SocQ отправит один POST со сводкой задачи после ее завершения, а записи вы прочитаете через эндпоинт задачи.
Сколько стоит типичная задача
- Получить 25 досок одного профиля: 25 × 0.5 = 12.5 кредита, $0.0625.
- Собрать 1,000 пинов с одной доски: 500 кредитов, $2.50.
- Проверить 20 тем: 10 кредитов, $0.05.
Поскольку results_limit применяется к каждому профилю или каждой доске, запрос с несколькими URL может вернуть до этого числа строк для каждого из них. Задавайте лимит с учетом количества URL.
FAQ
Возвращает ли User Boards приватные или секретные доски?
Нет. Он перечисляет публичные доски профиля.
Что означает число поисков в Topic?
search_count — это месячное число поисков, которое Pinterest сообщает для страницы идей. updated_at — время, когда Pinterest в последний раз обновил тему.
Можно ли получить пины нескольких досок в одном запросе?
Да. Укажите несколько URL досок в urls. results_limit применяется к каждой доске отдельно, и каждый возвращенный пин стоит 0.5 кредита.
Платить ли, если доска пустая?
Базовой платы нет, поэтому вы платите только за возвращенные доски, пины или темы.
Где указаны цены Pinterest?
На каждой посадочной странице указан ее тариф, а на странице цен перечислены текущие ставки в кредитах для всех API SocQ.
PINTEREST API
Проверить сценарий на публичном URL Pinterest
Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.
API для Pinterest