Google Trends Парсер

Создание задачи

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

Требует области действия google-trends для вашего API-ключа.

Эндпоинт

POST /api/parsing/v1/google-trends

Тело запроса

Параметр	Тип	Обязательный	Описание
q	string	да	Поисковый термин для анализа (например, `iphone`)
type	string[]	нет	Какие наборы данных собирать: `periods`, `geo`, `queries`, `topics`, `autocomplete`. По умолчанию `["periods","geo","queries","topics"]`
geo	string	нет	Код страны или региона (например, `US`, `GB`, `US-CA`). Не указывайте для всего мира
date	string	нет	Временной диапазон в синтаксисе Google Trends (например, `now 1-d`, `today 1-m`, `all`). По умолчанию `now 1-d`
cat	number	нет	ID категории Google Trends. `0` (по умолчанию) означает все категории
gprop	string	нет	Сервис Google для поиска: `web`, `images`, `news`, `froogle` (Shopping), `youtube`. По умолчанию `web`
hl	string	нет	Код языка интерфейса (например, `en-US`, `de-DE`). По умолчанию `en-US`
tz	number	нет	Смещение часового пояса в минутах от UTC (например, `0`, `-120`). По умолчанию `0`
resolution	string	нет	Детализация для интереса по регионам: `COUNTRY`, `REGION`, `CITY`, `DMA`. Если не указано, выбирается автоматически на основе `geo`
callbackUrl	string	нет	URL вебхука для отправки результата по завершении

Значения `type`

Значение	Возвращает	Поле ответа
periods	Интерес во времени по термину	`interestOverTime`
geo	Интерес в разбивке по регионам	`interestByGeo`
queries	Популярные и растущие связанные поисковые запросы	`relatedQueries`
topics	Популярные и растущие связанные темы	`relatedTopics`
autocomplete	Совпадающие сущности Google Trends (используется для уточнения термина)	`autocomplete`

Значения `date`

Принимается любая строка диапазона Google Trends. Распространённые предустановки:

Значение	Диапазон
now 1-d	Последний день
now 7-d	Последние 7 дней
today 1-m	Последние 30 дней
today 3-m	Последние 90 дней
today 12-m	Последние 12 месяцев
today 5-y	Последние 5 лет
all	С 2004 года по настоящее время

Значения `resolution`

Значение	Детализация
COUNTRY	Уровень страны
REGION	Уровень региона / штата
CITY	Уровень города
DMA	Медиарынок США (Designated Market Area)

Пример запроса

curl -X POST 'https://app.parsering.com/api/parsing/v1/google-trends' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"q":"iphone","type":["periods","geo","queries","autocomplete"],"geo":"US","date":"today 1-m","gprop":"web","hl":"en-US","callbackUrl":"https://my-server.com/webhook/parsing"}'

Пример ответа

{
  "id": "ac9c7911-b32c-4890-a850-227003ee2d35",
  "status": "parsing",
  "scope": "google-trends",
  "costCredits": 10,
  "createdAt": "2026-09-28T10:00:00.000Z"
}

Поле	Тип	Описание
id	string	ID задачи для опроса результата
status	string	Текущий статус задачи (`parsing`, `done`, `error`)
scope	string	Тип задачи — всегда `google-trends` для этого эндпоинта
costCredits	number	Количество кредитов, списанных за задачу
createdAt	string	Временная метка создания задачи в формате ISO 8601

Запрос стоит 10 кредитов независимо от того, сколько наборов данных type вы запрашиваете.

Задача обрабатывается асинхронно. Используйте id для опроса результата или укажите callbackUrl для получения вебхука по завершении парсинга.

Следующие шаги

Получение результата — опрос результата по ID задачи
Вебхуки — получение результата через callback вместо опроса
Тарифы — как рассчитываются кредиты для этого запроса