# Настройка live-задач «DataForSEO Trends Subregion Interests» **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live` **Tags:** DataForSEO Где сосредоточен интерес к ключевому слову, в разбивке по субрегионам внутри `location_code`. Ответ обёрнут в конверт DataForSEO: данные в `tasks[0].result`, результат в `tasks[0].status_code` — отклонённый запрос всё равно возвращает HTTP 200. Если нужны люди, а не места, используйте `post_dataforseo_keywords_trends_demography_live`. ### Справочная информация о ценах - Тарификация: заявленная стоимость ответа. - Справочная оценка запроса: USD 0.0024. - Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента. Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo. ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Request body Required: **no** ### application/json Schema: ```json { "type": "array", "items": { "type": [ "object", "null" ], "oneOf": [ { "type": "object", "properties": { "keywords": { "type": "array", "items": { "type": "string" }, "description": "ключевые слова
обязательное поле
максимальное количество ключевых слов: 5
избегайте символов и специальных знаков (например, UTF-символов, эмодзи);
если указать нелатинские символы, вы получите данные для стран, где они используются

Подробнее о правилах и ограничениях полей keyword и keywords в API DataForSEO читайте в статье Help Center" }, "location_name": { "type": [ "string", "null" ], "description": "полное название местоположения поисковой системы
необязательное поле
если не использовать это поле, вы получите глобальные результаты
если используете это поле, location_code указывать не нужно
список доступных местоположений поисковой системы с их location_name можно получить отдельным запросом к https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
данные будут предоставлены для страны, к которой относится указанный location_name;
пример:
United Kingdom" }, "location_code": { "type": [ "integer", "null" ], "description": "код местоположения поисковой системы
необязательное поле
если не использовать это поле, вы получите глобальные результаты
если используете это поле, location_name указывать не нужно
список доступных местоположений поисковых систем с их location_code можно получить отдельным запросом к https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
данные будут предоставлены для страны, к которой относится указанный location_code;
пример:
2840" }, "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "date_from": { "type": [ "string", "null" ], "description": "начальная дата временного диапазона
необязательное поле
если не указать это поле, по умолчанию будут использованы текущий день и месяц предыдущего года
минимальное значение для типа web: 2004-01-01
минимальное значение для других типов: 2008-01-01
формат даты: \"yyyy-mm-dd\"
пример:
\"2019-01-15\"" }, "date_to": { "type": [ "string", "null" ], "description": "конечная дата временного диапазона
необязательное поле
если не указать это поле, по умолчанию будет использована сегодняшняя дата
формат даты: \"yyyy-mm-dd\"
пример:
\"2019-01-15\"" }, "time_range": { "type": [ "string", "null" ], "description": "предустановленные временные диапазоны
необязательное поле
если указать параметры date_from или date_to, это поле будет проигнорировано при постановке задачи
возможные значения для всех параметров type:
past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years" }, "tag": { "type": [ "string", "null" ], "description": "пользовательский идентификатор задачи
необязательное поле
ограничение — 255 символов
этот параметр позволяет идентифицировать задачу и сопоставить её с результатом
указанное значение tag вы найдёте в объекте data ответа" } }, "example": [ { "keywords": [ "rugby", "cricket" ], "date_from": "2023-01-01", "date_to": "2024-01-01", "type": "web", "location_name": "United States" } ] } ] }, "example": [ { "keywords": [ "rugby", "cricket" ], "date_from": "2023-01-01", "date_to": "2024-01-01", "type": "web", "location_name": "United States" } ] } ``` ## Responses ### 200 — Успешная операция Headers: - `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveResponseInfo" } ] } ``` ### 400 — Запрос не удалось обработать. Проверьте параметры запроса. ### 401 — Требуется действительный API-ключ Felo. ### 402 — Запрос не может быть выполнен: не выполнено требование биллинга. ### 403 — Аккаунту не разрешено выполнять эту операцию. ### 429 — Достигнут лимит запросов или расходов. ### 502 — Сервис не смог выполнить запрос. ### 503 — API или сервис биллинга временно недоступны. ### 504 — Истекло время ожидания обработки запроса. ### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_AbsoluteItems `#/components/schemas/Response36Afe1097B20_AbsoluteItems` ```json { "type": "object", "properties": { "geo_id": { "type": [ "string", "null" ], "description": "идентификатор местоположения
это поле позволяет сопоставить полученные результаты с параметрами местоположения, указанными в запросе
полный список доступных местоположений с их geo_id смотрите здесь или получите отдельным запросом к https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
пример:
US-NY" }, "geo_name": { "type": [ "string", "null" ], "description": "название местоположения
это поле позволяет сопоставить полученные результаты с параметрами местоположения, указанными в запросе
полный список доступных местоположений с их geo_name смотрите здесь или получите отдельным запросом к https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
пример:
Andorra" }, "values": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "содержит данные об относительной популярности ключевых слов по странам или регионам" } } } ``` ### Response36Afe1097B20_BaseKeywordDataDataforseoTrendsItem `#/components/schemas/Response36Afe1097B20_BaseKeywordDataDataforseoTrendsItem` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "position": { "type": [ "integer", "null" ], "description": "выравнивание элемента
может принимать следующие значения: 1, 2, 3, 4 и т. д." }, "keywords": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "ключевые слова в массиве POST" } }, "additionalProperties": false, "discriminator": { "propertyName": "type", "mapping": { "dataforseo_trends_graph": "#/components/schemas/Response36Afe1097B20_DataforseoTrendsDataforseoTrendsGraphElementItem", "subregion_interests": "#/components/schemas/Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem", "demography": "#/components/schemas/Response36Afe1097B20_DataforseoTrendsDemographyElementItem" } } } ``` ### Response36Afe1097B20_BaseResponseInfo `#/components/schemas/Response36Afe1097B20_BaseResponseInfo` ```json { "properties": { "version": { "type": [ "string", "null" ], "description": "текущая версия API" }, "status_code": { "type": [ "integer", "null" ], "description": "общий код состояния.\nПолный список кодов ответа можно найти здесь." }, "status_message": { "type": [ "string", "null" ], "description": "общее информационное сообщение.\nПолный список общих информационных сообщений можно найти здесь." }, "time": { "type": [ "string", "null" ], "description": "общее время выполнения, секунды" }, "cost": { "type": [ "number", "null" ], "description": "общая стоимость задач, USD", "format": "double" }, "tasks_count": { "type": [ "integer", "null" ], "description": "число задач в массиве tasks", "format": "int64" }, "tasks_error": { "type": [ "integer", "null" ], "description": "число задач в массиве tasks, возвращённых с ошибкой", "format": "int64" } } } ``` ### Response36Afe1097B20_BaseResponseTaskInfo `#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo` ```json { "properties": { "id": { "type": [ "string", "null" ], "description": "идентификатор задачи\nуникальный идентификатор задачи в нашей системе в формате UUID" }, "status_code": { "type": [ "integer", "null" ], "description": "код состояния задачи\nформируется DataForSEO, может находиться в диапазоне 10000-60000\nПолный список кодов ответа можно найти здесь." }, "status_message": { "type": [ "string", "null" ], "description": "информационное сообщение задачи\nПолный список общих информационных сообщений можно найти здесь." }, "time": { "type": [ "string", "null" ], "description": "время выполнения, секунды" }, "cost": { "type": [ "number", "null" ], "description": "общая стоимость задач, USD", "format": "double" }, "result_count": { "type": [ "integer", "null" ], "description": "число элементов в массиве result", "format": "int64" }, "path": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "путь URL" }, "data": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "object", "null" ] }, "description": "содержит те же параметры, что вы указали в POST-запросе" } } } ``` ### Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem `#/components/schemas/Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseKeywordDataDataforseoTrendsItem" }, { "type": "object", "properties": { "interests": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoTrendsinterestsInfo" } ] }, "description": "данные о популярности ключевых слов в субрегионах для каждого указанного термина" }, "interests_comparison": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_InterestsComparison" } ], "description": "сравнение данных о популярности ключевых слов в субрегионах для указанных параметров
если вы указали одно ключевое слово, значение будет null" } } } ] } ``` ### Response36Afe1097B20_DataforseoTrendsinterestsInfo `#/components/schemas/Response36Afe1097B20_DataforseoTrendsinterestsInfo` ```json { "type": "object", "properties": { "keyword": { "type": [ "string", "null" ], "description": "соответствующее ключевое слово
данные в элементе values основаны на этом ключевом слове" }, "values": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoTrendsinterestsValuesInfo" } ] }, "description": "содержит данные об относительной популярности ключевых слов по странам или регионам" } } } ``` ### Response36Afe1097B20_DataforseoTrendsinterestsValuesInfo `#/components/schemas/Response36Afe1097B20_DataforseoTrendsinterestsValuesInfo` ```json { "type": "object", "properties": { "geo_id": { "type": [ "string", "null" ], "description": "идентификатор местоположения
это поле позволяет сопоставить полученные результаты с параметрами местоположения, указанными в запросе
полный список доступных местоположений с их geo_id смотрите здесь или получите отдельным запросом к https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
пример:
US-NY" }, "geo_name": { "type": [ "string", "null" ], "description": "название местоположения
это поле позволяет сопоставить полученные результаты с параметрами местоположения, указанными в запросе
полный список доступных местоположений с их geo_name смотрите здесь или получите отдельным запросом к https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
пример:
Andorra" }, "value": { "type": [ "integer", "null" ], "description": "относительный показатель популярности ключевого слова в заданной локации
представляет показатель популярности ключевого слова с учётом локации за указанный временной диапазон;
с помощью этого value можно понять, насколько ключевое слово популярно в одной локации по сравнению с другой;
расчёт: мы определяем наибольшее значение популярности соответствующего ключевого слова по всем локациям, а затем выражаем все остальные значения как процент от этого наибольшего значения (100);
значение 100 — наибольшая популярность термина
значение 50 означает, что термин вдвое менее популярен
значение 0 означает, что данных по этому термину недостаточно" } } } ``` ### Response36Afe1097B20_InterestsComparison `#/components/schemas/Response36Afe1097B20_InterestsComparison` ```json { "type": "object", "properties": { "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AbsoluteItems" } ] }, "description": "содержит популярность ключевого слова и связанные данные" }, "absolute_items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AbsoluteItems" } ] }, "description": "показатели популярности ключевых слов по всем местоположениям
значения в этом массиве представляют проценты относительно максимального значения по всем местоположениям" } } } ``` ### Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveResponseInfo `#/components/schemas/Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveResponseInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo" }, { "type": "object", "properties": { "tasks": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveTaskInfo" } ] }, "description": "массив задач" } } } ] } ``` ### Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveResultInfo `#/components/schemas/Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveResultInfo` ```json { "type": "object", "properties": { "keywords": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "ключевые слова в массиве POST" }, "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "location_code": { "type": [ "integer", "null" ], "description": "код местоположения в массиве POST
если данных нет, значение — null" }, "language_code": { "type": [ "string", "null" ], "description": "код языка в массиве POST
если данных нет, значение — null" }, "datetime": { "type": [ "string", "null" ], "description": "дата и время получения результата
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:
2019-11-15 12:57:46 +00:00" }, "items_count": { "type": [ "integer", "null" ], "description": "количество результатов, возвращённых в массиве items", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem" } ] }, "description": "содержит популярность ключевого слова и связанные данные" } } } ``` ### Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveTaskInfo `#/components/schemas/Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveTaskInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo" }, { "type": "object", "properties": { "result": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveResultInfo" } ] }, "description": "массив результатов" } } } ] } ```