Google Trends Парсер

Получение результата

Опрашивайте этот эндпоинт для получения результата отправленной задачи парсинга Google Trends.

Эндпоинт

GET /api/parsing/v1/result/google-trends/{requestId}

Продолжайте опрос, пока status не перестанет быть "parsing".

Параметры пути

Параметр	Тип	Обязательный	Описание
requestId	string (uuid)	да	ID задачи, возвращённый эндпоинтом отправки

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

curl https://app.parsering.com/api/parsing/v1/result/google-trends/YOUR_REQUEST_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

Ответы

В процессе — задача ещё обрабатывается:

{
  "status": "parsing"
}

Готово — задача выполнена успешно. Присутствуют только наборы данных, перечисленные в массиве type запроса:

{
  "data": {
    "input": {
      "q": "iphone",
      "hl": "en-US",
      "tz": 0,
      "cat": 0,
      "geo": "US",
      "date": "today 1-m",
      "type": ["periods", "geo", "queries", "autocomplete"],
      "gprop": "",
      "resolution": null,
      "original_url": "https://trends.google.com/explore?q=iphone&date=today%201-m&hl=en-US&geo=US"
    },
    "autocomplete": [
      { "mid": "/m/027lnzs", "type": "Mobile phone", "title": "iPhone" },
      { "mid": "/g/11jd9g0sn8", "type": "Mobile phone", "title": "IPhone 12" },
      { "mid": "/g/11fmzcj1r3", "type": "Mobile phone", "title": "iPhone 11" }
    ],
    "interestOverTime": [
      { "time": "2026-08-28T00:00:00.000Z", "value": 41 },
      { "time": "2026-08-29T00:00:00.000Z", "value": 44 },
      { "time": "2026-09-09T00:00:00.000Z", "value": 100 }
    ],
    "interestByGeo": [
      { "value": 100, "geoCode": "US-KS", "geoName": "Kansas" },
      { "value": 57, "geoCode": "US-CA", "geoName": "California" },
      { "value": 56, "geoCode": "US-NY", "geoName": "New York" }
    ],
    "relatedQueries": {
      "top": [
        { "query": "iphone 18", "value": 100 },
        { "query": "iphone 18 pro", "value": 51 },
        { "query": "iphone 17", "value": 49 }
      ],
      "rising": [
        { "query": "iphone 18 duo", "value": 51800 },
        { "query": "iphone duo", "value": 22700 },
        { "query": "iphone 18 pro case", "value": "+1,750%" }
      ]
    }
  },
  "success": true
}

Поля ответа

Поле	Тип	Описание
success	boolean	Успешно ли выполнен парсинг
data	object	Payload результата — содержит по одному ключу на каждый запрошенный `type`
data.input	object	Нормализованные параметры запроса, с которыми выполнялся парсинг
data.input.original_url	string	URL Google Trends Explore, эквивалентный этому запросу

data.interestOverTime — присутствует, если type включает periods:

Поле	Тип	Описание
time	string	Временная метка точки данных в формате ISO 8601
value	number	Относительный интерес поиска, `0`–`100` (`100` = пик диапазона)

data.interestByGeo — присутствует, если type включает geo:

Поле	Тип	Описание
geoName	string	Название региона (например, `Kansas`)
geoCode	string	Код региона (например, `US-KS`)
value	number	Относительный интерес поиска, `0`–`100`, нормализованный по возвращённым регионам

data.relatedQueries — присутствует, если type включает queries:

Поле	Тип	Описание
top	array	Самые популярные связанные запросы за период
top[].query	string	Связанный поисковый запрос
top[].value	number	Относительная популярность, `0`–`100`
rising	array	Запросы с наибольшим ростом за период
rising[].query	string	Связанный поисковый запрос
rising[].value	number \| string	Показатель роста — число для процентного роста или готовая строка вида `"+1,750%"`

data.relatedTopics — присутствует, если type включает topics. Та же структура top / rising, что и у relatedQueries, но вместо текста запроса — метаданные сущности темы (название и тип).

data.autocomplete — присутствует, если type включает autocomplete:

Поле	Тип	Описание
mid	string	ID сущности Google Knowledge Graph (например, `/m/027lnzs`)
title	string	Название сущности (например, `iPhone`)
type	string	Категория сущности (например, `Mobile phone`)

Значения Trends относительные, а не абсолютные объёмы поиска. 100 всегда отмечает пик в пределах возвращённого диапазона, поэтому значения из двух разных запросов напрямую не сравнимы.

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

Вебхуки — получение результата через callback вместо опроса
Создание задачи — вернуться к документации по эндпоинту отправки