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

Сезонность Google Trends для планирования спроса и запасов

Интерес в Google Trends по времени и регионам для любого ключевого слова в JSON: планируйте запуски, запасы и рекламу под реальный сезонный спрос.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
Google Trendslovelyjsonitems[0]"keyword": "patio heater""timeframe": "today 5-y""geo": "US""interest_over_time": "weekly series""interest_by_region": "state breakdown"

Если планировать запасы, рекламные бюджеты или контент-план на глаз, об осеннем всплеске вы узнаёте, когда он уже начался. Google Trends показывает, когда и где растёт интерес к товару, но только на графике, который читают вручную. Lovely Router выполняет запрос за вас. Отправьте ключевое слово, период и страну, получите один JSON-объект за вызов и платите за каждый вызов с предоплаченного баланса. Запускайте его из скрипта таблицы, задания планирования или ИИ-агента с одним API-ключом.

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

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

Сезонность Google Trends для планирования спроса и запасов. 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. Выберите ключевые слова

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

  2. Запустите инструмент для периода и страны

    Отправьте ключевое слово в POST /v1/tools/google-trends/run с mode, равным keyword, значением predefinedTimeframe, например today 5-y, и кодом страны в geo. Добавьте fetchRegionalData, чтобы получить разбивку по регионам.

  3. Сравнивайте по годам

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

02

Сезонный спрос одним запросом

Интерес в Google Trends принимает одно ключевое слово за вызов. predefinedTimeframe принимает значения от now 1-h до today 5-y и all. geo — код страны, пустое значение означает весь мир. Для разбивки по регионам страна должна быть задана:

curl https://lovelyrouter.com/v1/tools/google-trends/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "mode": "keyword",
      "keyword": "patio heater",
      "predefinedTimeframe": "today 5-y",
      "geo": "US",
      "fetchRegionalData": true
    },
    "max_results": 1
  }'

Вызов возвращает динамику интереса к ключевому слову во времени, а с fetchRegionalData — ещё и интерес по регионам. Запуск, который всё ещё идёт через 60 секунд, возвращает 202; как опрашивать его, показано в разделе Запуск инструмента.

03

Что содержит каждый вызов

Группа полейЧто вы получаете
Ключевое словоЗапрошенный термин в заданных периоде и стране
Интерес во времениКак менялся интерес к ключевому слову на протяжении периода
Интерес по регионамКак интерес распределяется по регионам, если включить fetchRegionalData и указать страну

Trends показывает относительный интерес, а не объёмы поиска. Используйте его, чтобы сравнивать недели, годы и регионы между собой, а не чтобы считать запросы.

04

Рецепты

Найдите настоящее начало сезона

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

Выберите регионы для запуска

Запустите ключевое слово с указанием страны и включённым fetchRegionalData и начните платную кампанию там, где интерес выше всего.

Сравните кандидатов в ассортимент

Запустите 10 ключевых слов с одинаковыми периодом и страной, затем ранжируйте их по устойчивости интереса, а не по единичному всплеску.

Убедитесь, что тренд — не мимолётная мода

Укажите all в качестве периода для растущего запроса. Если кривая — один пик, пропустите его; если это медленный рост, продолжайте.

Обновляйте таблицу планирования

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

Предпочитаете обычные слова? Подключите MCP-сервер и скажите Claude Code или Cursor: «Проверь в Google Trends „standing desk“ и „treadmill desk“ в США за последние 5 лет и скажи, когда каждый год начинает расти интерес. Один вызов на ключевое слово».

05

Сочетайте с данными поиска и маркетплейсов

Trends говорит, когда. Эти инструменты показывают, что продаётся и кто об этом говорит:

  • google-search показывает, что сегодня ранжируется по трендовым ключевым словам.
  • reddit-search показывает, что говорят люди, когда тема набирает популярность.
  • google-news показывает новости, стоящие за внезапным всплеском.

Более широкую картину рынка см. в разделе аналитика электронной коммерции.

06

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

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

Проверка 40 ключевых слов раз в месяц тарифицируется как 40 вызовов в месяц. Нет ни подписки, ни ежемесячного минимума: пополните баланс от $5, и один баланс оплачивает и инструменты, и модели. Актуальная цена — на карточке выше; все инструменты перечислены на странице цен.

07

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

?
Можно ли получить объёмы поиска из Google Trends?+

Нет. Результат показывает относительный интерес во времени и по регионам — ровно то, что показывает сам Trends. Он предназначен для сравнения периодов и мест.

Можно ли проверить несколько ключевых слов за один запуск?+

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

Какие периоды можно выбрать?+

now 1-h, now 4-h, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y и all.

Как получить трендовые запросы?+

Задайте mode равным trending и страну в geo, чтобы получить главные трендовые запросы этой страны вместо анализа одного ключевого слова.

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

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

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

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