高级功能

金融搜索

支持关键词、指定域名和时间范围的金融网页搜索

查看完整文档查看 Markdown 下载本页 MD

版本 1 更新于 2026-07-16 18:19

接口基本信息

接口名称: web_search
功能描述: 金融搜索接口，支持按关键词、指定域名、时间范围和语言区域检索网页结果。可不传关键词，仅根据指定域名检索内容。
数据更新频率: 实时
请求方法: POST
API 路径: https://api.wanxingai.com/v1/web-search/
认证方式: 请求头携带 Authorization: Bearer sk-********

输入参数说明

参数名	类型	必选	默认值	描述	示例
`query`	str	否	—	搜索关键词。可不传关键词，仅根据 `domains` 指定的网站检索内容	`英伟达财报资本开支`
`domains`	str	否	`""`	指定检索域名，多个域名用英文逗号分隔	`sec.gov,nvidia.com`
`freshness`	str	否	`""`	时间范围。支持 `oneday`、`oneweek`、`onemonth`、`oneyear`，也支持 `开始时间..结束时间` 自定义范围	`oneweek`
`count`	int	否	`10`	返回结果数量	`10`
`market`	str	否	`zh-CN`	市场区域	`zh-CN`
`set_lang`	str	否	`zh`	返回语言	`zh`

freshness 自定义时间示例

{
  "freshness": "2020-08-05 18:50:00..2020-08-07 21:52:00"
}

返回数据说明

返回 JSON 对象，格式为 {"status": 状态码, "message": 结果数据}；请求失败时返回 {"status": 状态码, "error": 错误信息}。

字段名	类型	描述
`status`	int	状态码。`200` 表示成功
`message`	array/object	搜索结果数据，具体结构以实际返回为准
`error`	str	错误信息，仅失败时返回

使用示例

import requests

url = "https://api.wanxingai.com/v1/web-search/"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-********"
}
payload = {
    "query": "英伟达 财报 资本开支",
    "domains": "sec.gov,nvidia.com",
    "freshness": "oneweek",
    "count": 10,
    "market": "zh-CN",
    "set_lang": "zh"
}

resp = requests.post(url, json=payload, headers=headers)
print(resp.json())

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        String json = """
        {
          "query": "英伟达 财报 资本开支",
          "domains": "sec.gov,nvidia.com",
          "freshness": "oneweek",
          "count": 10,
          "market": "zh-CN",
          "set_lang": "zh"
        }
        """;

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.wanxingai.com/v1/web-search/"))
            .header("Content-Type", "application/json")
            .header("Authorization", "Bearer sk-********")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

curl -X POST https://api.wanxingai.com/v1/web-search/ \\
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer sk-********" \\
  -d '{
    "query": "英伟达 财报 资本开支",
    "domains": "sec.gov,nvidia.com",
    "freshness": "oneweek",
    "count": 10,
    "market": "zh-CN",
    "set_lang": "zh"
  }'

注意事项

query 非必填；当只需要检索指定网站时，可以只传 domains
domains 多个域名用英文逗号分隔，不需要带 https://
freshness 为空时不限制时间范围；自定义时间范围使用 开始时间..结束时间 格式
接口需要鉴权，请在请求头中传入有效 API Key