# Live-результаты Google Finance Quote SERP в HTML **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/serp/google/finance_quote/live/html` **Tags:** DataForSEO Синхронно возвращает котировку тикера в том виде, как её показывает Google Finance. Это необработанный исходный код страницы, а не разобранные результаты. Обёрнуто в конверт DataForSEO: данные в `tasks[0].result`, результат в `tasks[0].status_code` — отклонённый запрос всё равно возвращает HTTP 200. ### Справочная информация о ценах - Тарификация: заявленная стоимость ответа. - Справочная оценка запроса: USD 0.02. - Справочный множитель для клиента: 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": { "keyword": { "type": "string", "description": "

тикер или биржевой символ

обязательное поле

в этом поле можно передать тикер публично торгуемых акций конкретной компании или ценной бумаги на конкретной бирже;

в поле keyword можно указать до 700 символов;

все %## будут декодированы (символ «+» декодируется в пробел)

если в keyword нужен символ «%», укажите его как «%25»;

если в keyword нужен символ «+», укажите его как «%2B»;


Подробнее о правилах и ограничениях полей keyword и keywords в API DataForSEO читайте в статье Help Center

" }, "location_code": { "type": "integer", "description": "

код местоположения поисковой системы

обязательное поле, если не указан location_name

если используете это поле, location_name указывать не нужно

список доступных местоположений поисковых систем и их location_code можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/google/locations

пример:

2840

" }, "language_code": { "type": "string", "description": "

код языка поисковой системы

обязательное поле, если не указан language_name

если используете это поле, language_name указывать не нужно

список доступных языков поисковой системы и их language_code можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/google/languages

пример:

en

" }, "device": { "type": [ "string", "null" ], "description": "

тип устройства

необязательное поле

возвращает результаты для определённого типа устройства

возможное значение: desktop

" }, "location_name": { "type": "string", "description": "

полное название местоположения поисковой системы

обязательное поле, если не указан location_code

если используете это поле, location_code указывать не нужно

список доступных местоположений поисковой системы и их location_name можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/google/locations

пример:

London,England,United Kingdom

" }, "language_name": { "type": "string", "description": "

полное название языка поисковой системы

обязательное поле, если не указан language_code

если используете это поле, language_code указывать не нужно

список доступных языков поисковой системы и их language_name можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/google/languages

пример:

English

" }, "os": { "type": [ "string", "null" ], "description": "

операционная система устройства

необязательное поле

возможные значения: windows

" }, "tag": { "type": [ "string", "null" ], "description": "

пользовательский идентификатор задачи

необязательное поле

ограничение — 255 символов

этот параметр позволяет идентифицировать задачу и сопоставить её с результатом

указанное значение tag вы найдёте в объекте data ответа

" }, "window": { "type": [ "string", "null" ], "description": "

временной диапазон графика google_finance_quote

необязательное поле

возможные значения: 1D, 5D, 1M, 6M, YTD, 1Y, 5Y, MAX

значение по умолчанию: 1D

" } }, "example": [ { "language_code": "en", "location_code": 2840, "keyword": "NASDAQ-100" } ] } ] }, "example": [ { "language_code": "en", "location_code": 2840, "keyword": "NASDAQ-100" } ] } ``` ## Responses ### 200 — Успешная операция Headers: - `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceQuoteLiveHtmlResponseInfo" } ] } ``` ### 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_HtmlItemInfo `#/components/schemas/Response36Afe1097B20_HtmlItemInfo` ```json { "type": "object", "properties": { "page": { "type": [ "integer", "null" ], "description": "порядковый номер возвращённой HTML-страницы" }, "date": { "type": [ "string", "null" ], "description": "дата и время сканирования HTML-страницы
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:
2019-11-15 12:57:46 +00:00" }, "html": { "type": [ "string", "null" ], "description": "HTML страница" } } } ``` ### Response36Afe1097B20_SerpGoogleFinanceQuoteLiveHtmlResponseInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceQuoteLiveHtmlResponseInfo` ```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_SerpGoogleFinanceQuoteLiveHtmlTaskInfo" } ] }, "description": "массив задач" } } } ] } ``` ### Response36Afe1097B20_SerpGoogleFinanceQuoteLiveHtmlResultInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceQuoteLiveHtmlResultInfo` ```json { "type": "object", "properties": { "keyword": { "type": [ "string", "null" ], "description": "ключевое слово, полученное в POST-массиве
ключевое слово возвращается с декодированным %## (символ '+' будет декодирован как пробел)" }, "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "se_domain": { "type": [ "string", "null" ], "description": "домен поисковой системы в массиве POST" }, "location_code": { "type": [ "integer", "null" ], "description": "код местоположения в массиве POST" }, "language_code": { "type": [ "string", "null" ], "description": "код языка в массиве POST" }, "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_HtmlItemInfo" } ] }, "description": "элементы результатов поиска, найденные в SERP" } } } ``` ### Response36Afe1097B20_SerpGoogleFinanceQuoteLiveHtmlTaskInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceQuoteLiveHtmlTaskInfo` ```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_SerpGoogleFinanceQuoteLiveHtmlResultInfo" } ] }, "description": "массив результатов" } } } ] } ```