API Google Trends
Google Trends показывает, как меняется поисковый интерес к запросу со временем. interest_over_time сравнивает до 5 ключевых слов и возвращает по одной записи на каждую точку времени со значением интереса от 0 до 100 для каждого ключевого слова.
Значения относительные: 100 — максимум для любого ключевого слова в запросе, поэтому результаты меняются, если добавить или убрать ключевое слово. Запросы с малым объёмом отображаются как 0. Точки идут по неделям за год, по дням за 30 или 90 дней и по часам или минутам за день или неделю; time указывает точное начало. Последняя точка часто ещё не досчитана (partial).
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Google Trends: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Динамика поискового интересаinterest_over_time | Сравнивайте поисковый интерес в Google к keywords (от 1 до 5) во времени. | $8.81 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Google Trends?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
interest_over_timeДинамика поискового интереса Сравнивайте поисковый интерес в Google к | keywords | country, language, search_type, time_window | Режим выдачи: Sync | — | $8.81 за 1 000 запросов | time · date_from · date_to · values · period_averages · partial · platform |
Что означают параметры действия interest_over_time в API Google Trends?
Сравнивайте поисковый интерес в Google к keywords (от 1 до 5) во времени. Каждая запись — одна точка во времени со значением от 0 до 100 для каждого ключевого слова относительно максимума в запросе. Выберите country, time_window от одного дня до пяти лет и search_type, например news или YouTube. Значения отражают относительный интерес, а не число запросов.
keywordsОбязательный- Список из 1–5 поисковых запросов для сравнения, например
["openai", "anthropic"]. Каждый запрос не длиннее 80 символов и 10 слов.Справка Google Trends: часто задаваемые вопросы о данных Google Trends — В справке Google Trends объясняется, что данные берутся из выборки реальных поисковых запросов, каждая точка делится на общее число запросов для своего места и периода и масштабируется от 0 до 100, а запросы с низкой частотой отображаются как 0. Источник подтверждает смысл `values`; фильтры `country`, `time_window` и `search_type` этого API определены EveryInfra, и источник не ручается за результаты. · Проверено countryНеобязательный- Двухбуквенный код страны, например
us,gbилиjp, в которой измеряется интерес. Без параметра данные берутся по всему миру. languageНеобязательный- Двухбуквенный код языка, например
enилиja. Обычно не нужен. search_typeНеобязательный- Тип поиска Google для измерения интереса:
web(по умолчанию),news,youtube,imagesилиshopping. time_windowНеобязательный- Охватываемый период:
day,week,month(30 дней),quarter(90 дней),year(12 месяцев, по умолчанию) илиfive_years.
Как использовать API Google Trends
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_trends","action":"interest_over_time","params":{"keywords":"<keywords>"}}'
Вопросы об API Google Trends
Какие данные можно получить через API Google Trends?
Укажите в platform значение google_trends. В текущем каталоге: динамика поискового интереса. Эти названия действий соответствуют разным объектам или представлениям Google Trends; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса interest_over_time к платформе Google Trends?
Список из 1–5 поисковых запросов для сравнения, например ["openai", "anthropic"]. Каждый запрос не длиннее 80 символов и 10 слов. Передайте это значение в поле keywords объекта params.
Какие поля может вернуть interest_over_time на платформе Google Trends?
Объявленная схема включает time, date_from, date_to и values. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Google Trends возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.