pinterest/
topic

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

Pinterest Topic API

URL страницы идей на входе
Месячное число поисков
Связанные темы со ссылками
0,5 кредита за результат
Готово
Готово

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

README

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

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

Отправьте ссылки на страницы идей и получите по одной строке на тему.

  1. Скопируйте ссылки на страницы идей в Pinterest и отправьте их в urls методом POST на /v1/pinterest/topic.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте по одной теме на элемент из 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: каждая цифра относится к последнему обновлению своей темы.

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

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

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

Pinterest Topic API — FAQ

Pinterest Topic API — это программный интерфейс для получения тем Pinterest по URL их страниц идей. Он возвращает название каждой темы, месячное число поисков по данным Pinterest, время последнего обновления этого числа и более узкие темы, предложенные внутри нее.

Он дает текущее месячное число поисков, которое Pinterest сообщает для каждой темы, вместе со временем обновления. Если регулярно собирать одни и те же темы, получится история, по которой можно построить график самостоятельно.

Страницы идей находятся в разделе pinterest.com/ideas/ и заканчиваются числовым id, как в /ideas/home-decor/935249274030/. Кроме того, каждая строка возвращает related_topics[].url уже в подходящем формате.

name — полное название темы, например Christmas Home Decor, а label — короткая метка, которую Pinterest показывает для нее, например Christmas.

Каждая возвращенная тема стоит 0,5 кредита, так что проверка десяти страниц идей обойдется в 5 кредитов.