# Расширенная Live-версия Google Finance Quote **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/serp/google/finance_quote/live/advanced` **Tags:** DataForSEO Синхронно возвращает котировку тикера в том виде, как её показывает Google Finance. Возвращает `keyword`, `type`, `se_domain`, `location_code`, `language_code`, `check_url`, `datetime`, `spell`, `refinement_chips`, `item_types`, `items_count` и `items`. `advanced` — выбор по умолчанию; берите `regular`, когда нужен только ранжированный список, и `html`, только чтобы проверить, что пропустил парсер. Обёрнуто в конверт DataForSEO: данные в `tasks[0].result`, результат в `tasks[0].status_code` — отклонённый запрос всё равно возвращает HTTP 200. ### Справочная информация о ценах - Тарификация: заявленная стоимость ответа. - Справочная оценка запроса: USD 0.002. - Справочный множитель для клиента: 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

Примечание: при указании значения, отличного от 1D, стоимость задачи умножается на 2

" } }, "example": [ { "keyword": "CLW00:NYMEX", "location_code": 2840, "language_name": "English" } ] } ] }, "example": [ { "keyword": "CLW00:NYMEX", "location_code": 2840, "language_name": "English" } ] } ``` ## Responses ### 200 — Успешная операция Headers: - `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceQuoteLiveAdvancedResponseInfo" } ] } ``` ### 400 — Запрос не удалось обработать. Проверьте параметры запроса. ### 401 — Требуется действительный API-ключ Felo. ### 402 — Запрос не может быть выполнен: не выполнено требование биллинга. ### 403 — Аккаунту не разрешено выполнять эту операцию. ### 429 — Достигнут лимит запросов или расходов. ### 502 — Сервис не смог выполнить запрос. ### 503 — API или сервис биллинга временно недоступны. ### 504 — Истекло время ожидания обработки запроса. ### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_AmazonLabelElement `#/components/schemas/Response36Afe1097B20_AmazonLabelElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "title": { "type": [ "string", "null" ], "description": "заголовок элемента" }, "url": { "type": [ "string", "null" ], "description": "URL поиска с параметрами уточнения" }, "domain": { "type": [ "string", "null" ], "description": "домен в SERP" } } } ``` ### 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_BaseSerpApiGoogleFinanceElementItem `#/components/schemas/Response36Afe1097B20_BaseSerpApiGoogleFinanceElementItem` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" } }, "additionalProperties": false, "discriminator": { "propertyName": "type", "mapping": { "google_finance_asset_pair_element": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceAssetPairElementElementItem", "google_finance_market_index_element": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceMarketIndexElementElementItem", "google_finance_market_instrument_element": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceMarketInstrumentElementElementItem", "google_finance_hero_groups": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceHeroGroupsElementItem", "google_finance_interested": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceInterestedElementItem", "google_finance_news": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceNewsElementItem", "google_finance_earnings_calendar": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceEarningsCalendarElementItem", "google_finance_most_followed": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceMostFollowedElementItem", "google_finance_market_trends": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceMarketTrendsElementItem", "google_finance_people_also_search": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinancePeopleAlsoSearchElementItem", "google_finance_explore_market_trends": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceExploreMarketTrendsElementItem", "google_finance_quote": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceQuoteElementItem", "google_finance_compare_to": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceCompareToElementItem", "google_finance_financial": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceFinancialElementItem", "google_finance_futures_chain": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceFuturesChainElementItem", "google_finance_details": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceDetailsElementItem", "google_finance_about": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceAboutElementItem" } } } ``` ### Response36Afe1097B20_RefinementChipsElement `#/components/schemas/Response36Afe1097B20_RefinementChipsElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "title": { "type": [ "string", "null" ], "description": "заголовок элемента" }, "url": { "type": [ "string", "null" ], "description": "URL поиска с параметрами уточнения" }, "domain": { "type": [ "string", "null" ], "description": "домен в SERP" }, "options": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AmazonLabelElement" } ] }, "description": "дополнительные параметры уточнения поиска" } } } ``` ### Response36Afe1097B20_RefinementChipsInfo `#/components/schemas/Response36Afe1097B20_RefinementChipsInfo` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "xpath": { "type": [ "string", "null" ], "description": "XPath элемента" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsElement" } ] }, "description": "дочерние элементы" } } } ``` ### Response36Afe1097B20_SerpGoogleFinanceQuoteLiveAdvancedResponseInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceQuoteLiveAdvancedResponseInfo` ```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_SerpGoogleFinanceQuoteLiveAdvancedTaskInfo" } ] }, "description": "массив задач" } } } ] } ``` ### Response36Afe1097B20_SerpGoogleFinanceQuoteLiveAdvancedResultInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceQuoteLiveAdvancedResultInfo` ```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" }, "check_url": { "type": [ "string", "null" ], "description": "прямой URL к результатам поисковой системы
с его помощью можно убедиться, что мы предоставили точные результаты" }, "datetime": { "type": [ "string", "null" ], "description": "дата и время получения результата
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:
2019-11-15 12:57:46 +00:00" }, "spell": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SpellInfo" } ], "description": "автокоррекция поисковой системы
если поисковая система предоставила результаты по исправленному ключевому слову, мы укажем исправленное поисковой системой ключевое слово и тип автокоррекции" }, "refinement_chips": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsInfo" } ], "description": "чипы уточнения поиска
в этом случае значение будет null" }, "item_types": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "типы результатов поиска в SERP
содержит типы результатов поиска (items), найденных в SERP;
возможные типы элементов: google_finance_hero_groups, google_finance_quote, google_finance_compare_to, google_finance_news, google_finance_financial, google_finance_futures_chain, google_finance_details, google_finance_about, google_finance_interested, google_finance_people_also_search" }, "se_results_count": { "type": [ "integer", "null" ], "description": " общее количество результатов в SERP", "format": "int64" }, "items_count": { "type": [ "integer", "null" ], "description": "количество результатов, возвращённых в массиве items", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseSerpApiGoogleFinanceElementItem" } ] }, "description": "элементы результатов поиска, найденные в SERP" } } } ``` ### Response36Afe1097B20_SerpGoogleFinanceQuoteLiveAdvancedTaskInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceQuoteLiveAdvancedTaskInfo` ```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_SerpGoogleFinanceQuoteLiveAdvancedResultInfo" } ] }, "description": "массив результатов" } } } ] } ``` ### Response36Afe1097B20_SpellInfo `#/components/schemas/Response36Afe1097B20_SpellInfo` ```json { "properties": { "keyword": { "type": [ "string", "null" ], "description": "ключевое слово, полученное в результате автокоррекции поисковой системы\nрезультаты будут предоставлены для исправленного ключевого слова" }, "type": { "type": [ "string", "null" ], "description": "тип автокоррекции\nвозможные значения:\ndid_you_mean, showing_results_for, no_results_found_for, including_results_for\nпримечание: Yahoo и Yandex поддерживают только следующий тип автокоррекции:\nincluding_results_for" } } } ```