Сценарий использования

Исследование трендов в Pinterest:
какие идеи люди сохраняют

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

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
Pinterestlovelyjsonitems[0]"title": "Minimalist living roo…"image": "https://i.pinimg.com/…"link": "https://www.pinterest…"saves": 18400

Дизайнеры, мерчандайзеры и контент-команды планируют на месяцы вперёд, а лучший сигнал для идей в интерьере, моде, еде и свадьбах — то, что люди сохраняют в Pinterest. Пролистывая сайт, вы получаете ощущение, а не таблицу. Lovely Router превращает поиск в данные. Отправьте ключевое слово, получите по одному JSON-объекту на пин и платите за каждый пин с предоплаченного баланса.

Передайте это своему ИИ-агенту

Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.

Исследование трендов в Pinterest: какие идеи люди сохраняют. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the inputs (links, keywords or accounts) and how many results you need>
01

Как это работает

010203
  1. Перечислите темы, за которыми следите

    Используйте обычные поисковые фразы, например minimalist living room, или вставьте ссылки на пины, доски, профили или поиск в Pinterest, чтобы начать с известного места.

  2. Запустите инструмент с ограничением

    Отправьте запрос на POST /v1/tools/pinterest-search/run с max_results. Запуск резервирует свою максимальную стоимость на вашем балансе и возвращает пины в виде JSON.

  3. Ранжируйте по сохранениям

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

02

Пины Pinterest по теме одним запросом

Поиск пинов в Pinterest принимает ключевое слово в search и ограничение на число пинов в maxItems:

curl https://lovelyrouter.com/v1/tools/pinterest-search/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
        "search": "minimalist living room",
        "maxItems": 30
      },
    "max_results": 30
  }'

Вместо ключевого слова можно передать startUrls: ссылки на пины, идеи, коллекции, профили или поиск. Запуск, который не завершился за 60 секунд, возвращает 202; как опрашивать его, показано в разделе Запуск инструмента.

03

Что содержит каждый пин

Группа полейЧто вы получаете
СодержаниеИзображение и заголовок
ИсточникСсылка на пин
СпросСохранения

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

04

Рецепты

Выберите цвета следующего сезона

Найдите пять фраз о палитрах, возьмите по 50 топовых пинов для каждой и сравните сохранения, чтобы понять, какие палитры люди оставляют себе.

Подготовьте бриф для дизайнера продукта

Найдите тип товара, возьмите 30 самых сохраняемых пинов и попросите модель описать общие формы, материалы и стилистику.

Спланируйте контент-календарь

Каждый месяц запускайте ключевые слова вашей категории и сохраняйте заголовки с числом сохранений. Растущие темы попадают в календарь.

Проверьте нишу перед запуском

Найдите стиль, который хотите продавать. Мало сохранений в первых 100 пинах говорит о слабом интересе, много — показывает, где спрос.

Изучите доски конкурента

Передайте ссылку на профиль или коллекцию в startUrls и посмотрите, какие их пины собирают больше всего сохранений.

Предпочитаете простые слова? Подключите MCP-сервер и скажите Claude Code или Cursor: «Найди в Pinterest „small balcony garden ideas“, получи 40 пинов, отсортируй их по сохранениям и назови три повторяющихся стиля. Задай max_results равным 40».

05

В паре с другими источниками трендов

Pinterest показывает, что люди сохраняют. Поиск и другие соцсети показывают, что они ищут и обсуждают:

  • google-trends показывает, как интерес к той же фразе меняется со временем.
  • instagram-hashtag показывает публикации по хештегу в Instagram.
  • tiktok-search находит видео в TikTok на ту же тему.
  • xiaohongshu-search охватывает такое же вдохновение в Xiaohongshu.

Для более широкого исследования аудитории см. исследование инфлюенсеров и мониторинг соцсетей.

06

Сколько это стоит

Вы платите за пин: при старте запуск резервирует свою максимальную стоимость — плата за вызов плюс плата за пин, умноженная на max_results, — а затем списывается за то, что он вернул. Остаток резерва возвращается на баланс. Запуск, который завершился ошибкой или по тайм-ауту, оплачивает только доставленные пины, а запуск, отклонённый на старте, ничего не стоит.

Сбор 200 пинов тарифицируется как 200 пинов. Нет ни подписки, ни ежемесячного минимума: пополняйте баланс от $5, и один баланс оплачивает и инструменты, и модели. Актуальная цена показана на карточке выше; на странице Цены перечислены все инструменты.

07

Частые вопросы

?
Что входит в результат по пину?+

Изображение, заголовок, ссылка и число сохранений.

Можно ли начать с доски или профиля Pinterest?+

Да. Передайте ссылки на пины, идеи, коллекции, профили или поиск в startUrls.

Сколько пинов может вернуть один запуск?+

До 200 пинов; задаётся через max_results.

Показывают ли сохранения, какие тренды растут?+

Сохранения — это число на момент запуска. Чтобы увидеть рост, запускайте один и тот же поиск по расписанию и сравнивайте запуски.

Нужна ли подписка?+

Нет. Вы пополняете предоплаченный баланс, и каждый запуск списывает с него. Неудачные запуски оплачивают только доставленные результаты, и ничего не продлевается автоматически.

Один предоплаченный ключ для моделей, данных и агентов

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