Google Finance Ticker Search 实时高级版

接口说明

实时 Google Finance Ticker Search 用于按名称或金融名称检索 Google Finance 中可用的金融标的，并返回更丰富的结构化信息。

返回结果会受到以下请求参数影响：

keyword：名称或金融名称
location：搜索地域
language：搜索语言

请求地址

POST https://api.seermartech.cn/v3/serp/google/finance_ticker_search/live/advanced

计费说明

该接口按请求计费，每次请求都会扣费。

参考价约 ¥0.0320 / 次 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求规则

请求体为 UTF-8 编码的 JSON
POST 数据需使用数组格式：[{ ... }]
每次 Live SERP 请求支持 1 个任务
频率上限为 每分钟 2000 次 API 调用

请求参数

主要参数

字段名	类型	说明
`keyword`	string	填。名称或金融名称，用于搜索 ticker。最长支持 700 个字符。请求中的 `%##` 会被解码，`+` 会被解码为空格；如需传递 `%`，请写为 `%25`；如需传递 `+`，请写为 `%2B`。
`location_code`	integer	如果未传 `location_name`，则为填。搜索引擎地域编码。传该字段时无需再传 `location_name`。示例：`2840`。可通过 `/v3/serp/google/locations` 获取可用地域列表。
`language_code`	string	如果未传 `language_name`，则为填。搜索引擎语言编码。传该字段时无需再传 `language_name`。示例：`en`。可通过 `/v3/serp/google/languages` 获取可用语言列表。

可选参数

字段名	类型	说明
`location_name`	string	如果未传 `location_code`，则为填。搜索引擎地域完整名称。传该字段时无需再传 `location_code`。示例：`London,England,United Kingdom`。可通过 `/v3/serp/google/locations` 获取。
`language_name`	string	如果未传 `language_code`，则为填。搜索引擎语言完整名称。传该字段时无需再传 `language_code`。示例：`English`。可通过 `/v3/serp/google/languages` 获取。
`tag`	string	可选。用户自定义任务标识，最长 255 个字符。可用于结果归因与任务匹。响应中的 `data` 对象会返回该值。
`category`	string	可选。金融搜索类别。可选值：`all`、`stock`、`index`、`mutual_fund`、`currency`、`futures`。默认值：`all`。

返回结果说明

接口返回 JSON 数据，顶层 tasks 数组。

顶层字段

字段名	类型	说明
`version`	string	API 当前版本。
`status_code`	integer	局状态码。完整列表参考 `/v3/appendix/errors`。建议对异常和错误状态建立完善的处理机制。
`status_message`	string	局状态信息。完整列表参考 `/v3/appendix/errors`。
`time`	string	执行耗时，单位秒。
`cost`	float	本次请求总成本，单位 USD。
`tasks_count`	integer	`tasks` 数组中的任务数量。
`tasks_error`	integer	返回错误的任务数量。
`tasks`	array	任务结果数组。

tasks 数组字段

字段名	类型	说明
`id`	string	任务唯一标识，UUID 格式。
`status_code`	integer	任务状态码，范围通常为 `10000-60000`。完整列表参考 `/v3/appendix/errors`。
`status_message`	string	任务状态信息。
`time`	string	任务执行耗时，单位秒。
`cost`	float	任务成本，单位 USD。
`result_count`	integer	`result` 数组中的数量。
`path`	array	URL 路径。
`data`	object	与请求中提交的参数一致。
`result`	array	获取结果数组。

result 数组字段

字段名	类型	说明
`keyword`	string	POST 中提交的。返回时 `%##` 会被解码，`+` 会被解码为空格。
`type`	string	搜索类型。此接口固定为 `finance_ticker_search`。
`se_domain`	string	请求中的搜索引擎域名。
`location_code`	string	请求中的地域编码。
`language_code`	string	请求中的语言编码。
`check_url`	string	指向搜索结果页面的直达链接，可用于核验结果准确性。
`datetime`	string	抓取结果时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。示例：`2019-11-15 12:57:46 +00:00`
`spell`	object	搜索引擎自动纠错信息。如果平台使用了纠正后的返回结果，会在此说明纠错后的及类型。
`refinement_chips`	object	搜索细化标签。本接口中该值为 `null`。
`item_types`	array	SERP 中出现的结果类型。可能值：`google_finance_market_index`、`google_finance_asset_pair`、`google_finance_market_instrument`。
`se_results_count`	integer	SERP 结果总数。
`items_count`	integer	`items` 数组中的结果数量。
`items`	array	SERP 中检索到的结果项。

items 结果项类型

1）`google_finance_market_index`

市场指数结果项。

字段名	类型	说明
`type`	string	固定为 `google_finance_market_index`
`rank_group`	integer	同类型结果排名。不同 `type` 的结果不计该排名。
`rank_absolute`	integer	SERP 中的绝对排名。
`ticker`	string	指数 ticker。示例：`DAX`
`market_identifier`	string	市场标识符。示例：`INDEXDB`
`index_value`	float	在指定 `timestamp` 时点的指数值。
`index_value_delta`	float	在指定 `timestamp` 时点的指数值变动。
`identifier`	string	完整标识符，由 `ticker` 和 `market_identifier` 组成。示例：`PX1:INDEXDB`
`displayed_name`	string	Google Finance 上显示的指数名称。示例：`CAC 40`
`url`	string	指数页链接。
`location`	string	指数所在地区。示例：`Europe/Paris`
`trend`	string	趋势方向，可选值：`up`、`down`、`stable`
`timestamp`	string	指数值读取时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。示例：`2025-02-10 09:40:00 +00:00`
`percentage_delta`	float	指数值变化百分比。

2）`google_finance_asset_pair`

资产对结果项，如汇率对。

字段名	类型	说明
`type`	string	固定为 `google_finance_asset_pair`
`rank_group`	integer	同类型结果排名。
`rank_absolute`	integer	SERP 中的绝对排名。
`base_symbol`	string	资产对中的基础资产标识。示例：`EUR`
`quote_symbol`	string	资产对中的计价资产标识。示例：`USD`
`base_display_name`	string	基础资产称。示例：`Euro`
`quote_display_name`	string	计价资产称。
`price`	float	基础资产相对于计价资产的价格。
`price_delta`	float	在指定 `timestamp` 时点的价格变化。
`identifier`	string	金融资产对标识。示例：`EUR-USD`
`displayed_name`	string	展示名称。示例：`EUR / USD`
`url`	string	资产对页链接。
`location`	string	所在市场位置。
`trend`	string	趋势方向，可选值：`up`、`down`、`stable`
`timestamp`	string	价格读取时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。示例：`2025-02-10 09:40:00 +00:00`
`percentage_delta`	float	价格变化百分比。

3）`google_finance_market_instrument`

市场金融结果项。

字段名	类型	说明
`type`	string	固定为 `google_finance_market_instrument`
`rank_group`	integer	同类型结果排名。
`rank_absolute`	integer	SERP 中的绝对排名。
`ticker`	string	金融 ticker。示例：`YMW00`
`price`	float	在指定 `timestamp` 时点的价格。
`price_delta`	float	在指定 `timestamp` 时点的价格变动。
`price_currency`	string	价格货币。示例：`USD`
`identifier`	string	完整标识符。示例：`YMW00:CBOT`
`displayed_name`	string	展示名称。示例：`E-mini Dow ($5)`
`url`	string	金融页链接。
`location`	string	所在市场位置。
`trend`	string	趋势方向，可选值：`up`、`down`、`stable`
`timestamp`	string	价格读取时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。示例：`2025-02-10 09:40:00 +00:00`
`percentage_delta`	float	价格变化百分比。

请求示例

cURL

bash

curl --location --request POST "https://api.seermartech.cn/v3/serp/google/finance_ticker_search/live/advanced" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "keyword": "DJ",
 "location_code": 2840,
 "language_name": "English"
 }
]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/serp/google/finance_ticker_search/live/advanced"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "keyword": "DJ",
 "location_code": 2840,
 "language_name": "English"
 }
]

response = requests.post(url, headers=headers, json=data)
print(response.json)

TypeScript

typescript

import axios from "axios";

async function main {
 const response = await axios.post(
 "https://api.seermartech.cn/v3/serp/google/finance_ticker_search/live/advanced",
 [
 {
 keyword: "DJ",
 location_code: 2840,
 language_name: "English",
 },
 ],
 {
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
 }
 );

 // 返回结果
 console.log(response.data);
}

main.catch(console.error);

响应示例

json

{
 "version": "0.1.20241227",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "1.7881 sec.",
 "cost": 0.002,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "serp",
 "function": "live",
 "se": "google",
 "se_type": "finance_ticker_search",
 "language_name": "English",
 "location_code": 2840,
 "category": "all",
 "keyword": "DJ",
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "se_results_count": 0,
 "items_count": 4,
 "items": []
 }
 ]
 }
 ]
}

错误处理

-局状态码见：/v3/appendix/errors

任务状态码见：/v3/appendix/errors

建议至少处理以下场景：

请求参数缺失或格式错误
location_code / language_code 无效
编码不符合要求
请求频率限
搜索结果为空或无可用 ticker

使用建议

优使用 location_code 和 language_code，便于程序稳定调用
若需要缩小结果范围，可结合 category 过滤股票、指数、基金、货币对或期货
对返回的 item_types 做分支处理，以适不同金融标的结构
使用 check_url 对结果进行抽样核验
以 timestamp 和 datetime 区分“抓取时间”与“市场值时间点”

实用场景

检索股票代码：根据名快速匹可交易 ticker，便于证券、财经或投研系统做标的归一化。
识别指数与期货标的：模糊金融名称后区分指数、期货、货币对等类型，提升金融数据洗效率。
构建财经联想词库：根据用户的或资产名称回收金融标识，用于财经站搜索和推荐增强。
校验金融实体映射：将 displayed_name、ticker、identifier 交叉比对，提升库与库的实体匹准确率。
监控多地区搜索表现差异：结合不同 location 与 language 查询同一金融标的，分析跨市场命名与展示差异。

Google Finance Ticker Search 实时高级版 ​

接口说明 ​

请求地址 ​

计费说明 ​

请求规则 ​

请求参数 ​

主要参数 ​

可选参数 ​

返回结果说明 ​

顶层字段 ​

tasks 数组字段 ​

result 数组字段 ​

items 结果项类型 ​

1）google_finance_market_index ​

2）google_finance_asset_pair ​

3）google_finance_market_instrument ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

错误处理 ​

使用建议 ​

实用场景 ​