# Историческая массовая оценка трафика **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/dataforseo_labs/google/historical_bulk_traffic_estimation/live` **Tags:** DataForSEO Оценка органического трафика для многих доменов в каждой точке доступной истории — временной ряд, лежащий в основе `post_dataforseo_labs_google_bulk_traffic_estimation_live`. Здесь нет параметра limit, но оплата идёт за вызов, а не за элемент, поэтому отправляйте весь список сразу. Ответ обёрнут в конверт DataForSEO: данные в `tasks[0].result`, результат в `tasks[0].status_code` — отклонённый запрос всё равно возвращает HTTP 200. ⚠️ Размер ответа равен произведению числа доменов на число дат; держите оба списка короткими. Доступные даты берутся из `get_dataforseo_labs_google_available_history`. ### Справочные цены - Тарификация: стоимость ответа по данным провайдера. - Справочная оценка запроса: USD 0.1356. - Справочный множитель для клиента: 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": { "targets": { "type": "array", "items": { "type": "string" }, "description": "целевые домены и поддомены
обязательное поле
в этом поле можно указать домены и поддомены;
домены и поддомены указываются без https:// и www.;
можно указать до 1000 доменов или поддоменов" }, "location_name": { "type": [ "string", "null" ], "description": "полное название местоположения
если используете это поле, location_code указывать не обязательно
список доступных местоположений с location_name можно получить отдельным запросом к
https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
игнорируйте это поле, чтобы получить результаты для всех доступных местоположений
пример:
United Kingdom" }, "location_code": { "type": [ "integer", "null" ], "description": "код местоположения
если используете это поле, location_name указывать не обязательно
список доступных местоположений с location_code можно получить отдельным запросом к
https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
игнорируйте это поле, чтобы получить результаты для всех доступных местоположений
пример:
2840" }, "language_name": { "type": [ "string", "null" ], "description": "полное название языка
если используете это поле, language_code указывать не нужно
список доступных языков с language_name можно получить отдельным запросом к
https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
игнорируйте это поле, чтобы получить результаты для всех доступных языков
пример:
English" }, "language_code": { "type": [ "string", "null" ], "description": "код языка
если используете это поле, language_name указывать не нужно
список доступных языков с language_code можно получить отдельным запросом к
https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
игнорируйте это поле, чтобы получить результаты для всех доступных языков
пример:
en" }, "date_from": { "type": [ "string", "null" ], "description": "начальная дата временного диапазона
необязательное поле
если не указать это поле, данные будут предоставлены за предыдущие 12 месяцев
минимально возможное значение: 2020-10-01
формат даты: \"yyyy-mm-dd\"" }, "date_to": { "type": [ "string", "null" ], "description": "конечная дата временного диапазона
необязательное поле
если не указать это поле, по умолчанию будет использоваться сегодняшняя дата;
формат даты: \"yyyy-mm-dd\"
пример:
\"2021-04-01\"" }, "ignore_synonyms": { "type": [ "boolean", "null" ], "description": "игнорировать очень похожие ключевые слова
необязательное поле
если установлено true, будут возвращены только основные ключевые слова, все очень похожие ключевые слова будут исключены;
значение по умолчанию: false" }, "item_types": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "отображение результатов по типу элемента
необязательное поле
указывает тип результатов поиска, включаемых в ответ;
Примечание: если массив item_types содержит типы элементов, отличные от organic, результаты будут упорядочены по первому типу элемента в массиве;
возможные значения:
[\"organic\", \"paid\", \"featured_snippet\", \"local_pack\"]
значение по умолчанию:
[\"organic\", \"paid\"]" }, "tag": { "type": [ "string", "null" ], "description": "пользовательский идентификатор задачи
необязательное поле
ограничение — 255 символов
этот параметр позволяет идентифицировать задачу и сопоставить её с результатом
указанное значение tag вы найдёте в объекте data ответа" } }, "example": [ { "targets": [ "dataforseo.com", "cnn.com", "forbes.com" ], "location_code": 2840, "language_code": "en", "date_from": "2021-01-01", "date_to": "2021-03-29", "item_types": [ "organic", "paid" ] } ] } ] }, "example": [ { "targets": [ "dataforseo.com", "cnn.com", "forbes.com" ], "location_code": 2840, "language_code": "en", "date_from": "2021-01-01", "date_to": "2021-03-29", "item_types": [ "organic", "paid" ] } ] } ``` ## Responses ### 200 — Успешная операция Headers: - `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResponseInfo" } ] } ``` ### 400 — Запрос не удалось обработать. Проверьте параметры запроса. ### 401 — Требуется действительный API-ключ Felo. ### 402 — Запрос не может быть выполнен: не выполнено требование биллинга. ### 403 — Аккаунту не разрешено выполнять эту операцию. ### 429 — Достигнут лимит запросов или расходов. ### 502 — Сервис не смог выполнить запрос. ### 503 — API или сервис биллинга временно недоступны. ### 504 — Истекло время ожидания обработки запроса. ### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера **application/json** Schema: ```json {} ``` ## Schema definitions ### 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_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveItem `#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveItem` ```json { "type": "object", "properties": { "se_type": { "type": [ "string", "null" ], "description": "тип поисковой системы" }, "target": { "type": [ "string", "null" ], "description": "целевой домен в POST-массиве" }, "metrics": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_HistoricalMetricsBundleInfo" } ], "description": "данные трафика, относящиеся к указанному домену" } } } ``` ### Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResponseInfo `#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResponseInfo` ```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_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveTaskInfo" } ] }, "description": "массив задач" } } } ] } ``` ### Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResultInfo `#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResultInfo` ```json { "type": "object", "properties": { "se_type": { "type": [ "string", "null" ], "description": "тип поисковой системы" }, "location_code": { "type": [ "integer", "null" ], "description": "код местоположения в массиве POST
если данных нет, значение — null" }, "language_code": { "type": [ "string", "null" ], "description": "код языка в массиве POST
если данных нет, значение — null" }, "total_count": { "type": [ "integer", "null" ], "description": "общее количество результатов в нашей базе данных, соответствующих вашему запросу", "format": "int64" }, "items_count": { "type": [ "integer", "null" ], "description": "количество результатов, возвращённых в массиве items", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveItem" } ] }, "description": "массив элементов с данными оценки соответствующего трафика" } } } ``` ### Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveTaskInfo `#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveTaskInfo` ```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_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResultInfo" } ] }, "description": "массив результатов" } } } ] } ``` ### Response36Afe1097B20_HistoricalMetricsBundleInfo `#/components/schemas/Response36Afe1097B20_HistoricalMetricsBundleInfo` ```json { "type": "object", "properties": { "organic": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_HistoricalMetricsInfo" } ] }, "description": "данные о трафике из органического поиска" }, "paid": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_HistoricalMetricsInfo" } ] }, "description": "данные о трафике из платного поиска" }, "local_pack": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_HistoricalMetricsInfo" } ] }, "description": "данные о трафике из локального блока результатов в SERP" }, "featured_snippet": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_HistoricalMetricsInfo" } ] }, "description": "данные о трафике из избранных фрагментов в Google SERP" } } } ``` ### Response36Afe1097B20_HistoricalMetricsInfo `#/components/schemas/Response36Afe1097B20_HistoricalMetricsInfo` ```json { "type": "object", "properties": { "year": { "type": [ "integer", "null" ], "description": "год, за который предоставлены данные" }, "month": { "type": [ "integer", "null" ], "description": "месяц, за который предоставлены данные" }, "etv": { "type": [ "number", "null" ], "description": "оценка объёма трафика
оценка ежемесячного органического трафика на домен
рассчитывается как произведение CTR (click-through-rate) и значений поискового объёма всех ключевых слов, по которым домен ранжируется
Подробнее о том, как рассчитывается эта метрика, — в этой статье справочного центра" }, "count": { "type": [ "integer", "null" ], "description": "общее число органических SERP, содержащих домен", "format": "int64" } } } ```