# 实时 Google Finance 行情高级版 **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。 ### 计费参考 - 计量方式：按上报的响应成本计量。 - 参考请求估算：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”；


有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制，请参阅这篇 帮助中心文章

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

搜索引擎地点代码

未指定 location_name 时为必填字段

如果使用此字段，则无需指定 location_name

可单独向 https://api.dataforseo.com/v3/serp/google/locations 发起请求，获取搜索引擎的可用地点及其 location_code 列表

示例：

2840

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

搜索引擎语言代码

未指定 language_name 时为必填字段

如果使用此字段，则无需指定 language_name

可单独向 https://api.dataforseo.com/v3/serp/google/languages 发起请求，获取搜索引擎的可用语言及其 language_code 列表

示例：

en

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

设备类型

可选字段

返回特定设备类型的结果

可能的值：desktop

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

搜索引擎地点全名

未指定 location_code 时为必填字段

如果使用此字段，则无需指定 location_code

可单独向 https://api.dataforseo.com/v3/serp/google/locations 发起请求，获取搜索引擎的可用地点及其 location_name 列表

示例：

London,England,United Kingdom

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

搜索引擎语言全名

未指定 language_code 时为必填字段

如果使用此字段，则无需指定 language_code

可单独向 https://api.dataforseo.com/v3/serp/google/languages 发起请求，获取搜索引擎的可用语言及其 language_name 列表

示例：

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 — 需要有效的 Felo API 密钥。 ### 402 — 由于未满足计费要求，请求无法继续。 ### 403 — 该账户无权执行此操作。 ### 429 — 已达到请求或支出限额。 ### 502 — 服务无法完成该请求。 ### 503 — API 或计费服务暂时不可用。 ### 504 — 服务在处理请求时超时。 ### default — 错误响应；上游透传响应可能采用提供方格式 **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": "任务总费用，美元", "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": "任务总费用，美元", "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 中的搜索结果类型
包含在 SERP 中找到的搜索结果类型（items）；
可能的条目类型：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 可能的值：\n did_you_mean、showing_results_for、no_results_found_for、including_results_for\n 注意：Yahoo 和 Yandex 仅支持以下自动更正类型：\n including_results_for" } } } ```