Pinterest Topic
Тема Pinterest — это страница идей, которая объединяет пины вокруг одного сюжета, например home decor, и содержит месячное число поисков по данным Pinterest, дату обновления этой цифры и набор более узких тем вроде вариаций Christmas или Thrifted. Эти цифры показывают, какой спрос есть на тему в Pinterest, а более узкие темы подсказывают стили, поводы и материалы, с которыми ее сочетают, и это основа для подбора ключевых слов и планирования контента.
Возможности Pinterest Topic API
- Месячное число поисков по каждой темеsearch_count — число поисков в месяц, которое Pinterest сообщает для темы, прямая мера того, как часто ее ищут.
- Более узкие темы со своими ссылкамиrelated_topics перечисляет подтемы, которые предлагает Pinterest, и у каждой есть полное название, короткая метка вроде DIY и url ее страницы идей.
- Время обновления цифрыupdated_at фиксирует, когда Pinterest в последний раз обновил тему, так что видно, насколько актуально число поисков.
- Много тем в одном запросеurls принимает сразу несколько страниц идей, и каждая возвращает ровно одну строку с ключом по id темы из адреса страницы.
Параметры Pinterest Topic API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Ссылки на страницы идей Pinterest в формате /ideas/{topic}/{id}/ с числовым id, например https://www.pinterest.com/ideas/home-decor/935249274030/. |
Как использовать Pinterest Topic API
Отправьте ссылки на страницы идей и получите по одной строке на тему.
- Скопируйте ссылки на страницы идей в Pinterest и отправьте их в urls методом POST на /v1/pinterest/topic.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте по одной теме на элемент из results.items; если has_more равно true, получите остальное с results.next_cursor.
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/"]}'
# One row and 0.5 credits per topic.Сценарии использования Pinterest Topic API
- Ранжирование идей контента по спросу: Соберите search_count для списка тем-кандидатов и начните с тех, которые ищут чаще всего, прежде чем планировать пины или доски.
- Поиск узких направлений внутри широкой темы: Читайте метки в related_topics, например Christmas, Thrifted или Earthy Cottage внутри home decor, чтобы выбрать более узкое направление с понятной аудиторией.
- Собственная история спроса в Pinterest: Собирайте те же темы каждый месяц и сохраняйте search_count с updated_at, чтобы строить график изменения интереса к каждой теме.
Практические советы по Pinterest Topic API
- Сохраняйте числовой id в каждой ссылке: /ideas/home-decor/935249274030/ принимается, а адрес, заканчивающийся названием темы, не проходит проверку.
- Расширяйте нишу уровень за уровнем, отправляя related_topics[].url следующим пакетом, и отбрасывайте уже собранные id тем: ветви часто ведут обратно к тем же страницам идей.
- Сравнивайте search_count разных тем только вместе с updated_at: каждая цифра относится к последнему обновлению своей темы.
Связанные API
Помимо Pinterest Topic API, используйте эти API, когда нужен другой тип публичных данных Pinterest.
- Pinterest Pins API — Преобразуйте URL публичных пинов в нормализованный контент, автора, медиа, таксономию, метки времени и видимые метрики.
- Pinterest User Pins API — Находите публичные пины по URL профилей с лимитом на профиль: нормализованный контент, автор, медиа, метки времени и видимые метрики.
- Pinterest Profiles API — Собирайте по URL профилей публичные данные аккаунта, описание, изображение, сайт, видимые счетчики и контекст сбора.
- Pinterest Search API — Ищите публичные пины по текстовому запросу с лимитом результатов и получайте нормализованный контент, автора, медиа, таксономию, метки времени и видимые метрики.
- Pinterest User Boards API — Получайте доски профилей Pinterest по URL профилей: названия, описания, обложки, даты создания и число пинов, подписчиков, разделов и соавторов.
- Pinterest Board Pins API — Собирайте пины доски Pinterest по ее URL в порядке доски: текст пина, сохранивший аккаунт, изображения в полном размере и ссылки на пины.