高级查询构建
在使用 finlight.me API 时，您可以通过高级查询构建技术精确检索所需的数据。本指南将带您了解复杂的过滤、排序和分页方法，帮助您优化数据检索过程。
使用我们的 控制台 - API 测试器，快速访问 API 并测试您的查询。
语言与多语言覆盖
finlight 索引多种语言的新闻，但每个请求都会被过滤为一种语言。language 参数默认为 en，因此如果您不设置它，您将只收到英语文章 —— 任何其他语言的内容都会被静默排除。
重要：
language默认为en。不带language的请求仅返回英语结果。以其他语言发布的文章（例如许多中文媒体，zh）不会被返回，除非您明确请求该语言。
工作原理
- 文章级别，精确匹配。
language会按每篇文章的 ISO 639-1 代码进行精确匹配过滤。language=en仅返回en文章，绝不返回de、zh等。 - 每个请求一种语言。
language接受单个值 —— 不支持数组/逗号列表，也没有“所有语言”选项。要覆盖多种语言，请为每种语言发送一个请求并合并结果。 - 来源可以是多语言的。 单个来源可能以多种语言发布；过滤器按文章的语言而非来源进行选择。某个媒体的非英语文章只有在您请求该语言时才会出现。
示例
默认（仅英语）—— 等价：
query=Alibaba
query=Alibaba&language=en
中文覆盖：
query=Alibaba&language=zh
覆盖英语 + 中文 —— 两个请求，然后合并：
query=Alibaba&language=en
query=Alibaba&language=zh
提示： 使用 ISO 639-1 代码（
en、de、fr、zh等）。finlight 的默认来源集涵盖多种语言 —— 英语只是默认过滤器，而非覆盖范围的上限。
查询过滤
query 参数支持灵活的基于关键字的逻辑以及字段级精度。您现在可以针对特定字段，例如 ticker、exchange、isin、source、openfigi 等。
基本关键字用法
单个关键字：
query=Nvidia stock
精确短语： 用双引号包裹短语以搜索精确匹配。
query="Elon Musk"
使用运算符进行包含/排除
强制包含 (+) 和排除 (-)：
使用 + 来要求/包含，使用 - 来排除词语或字段特定的值。
query=stock +market -google
这将返回包含 “stock” 和 “market” 但排除任何提到 “google” 的文章。
字段级过滤
注意： 这是一项强大的新功能，允许您直接在
query参数中基于特定字段过滤结果。
您现在可以使用 field:value 语法在 query 参数上直接查询特定字段。这使得查询更精确、更复杂，让您能够基于股票代码、交易所、ISIN、来源等特定属性过滤结果。
✨ 新功能： 对
source、ticker和exchange字段使用通配符*以匹配所有值（例如source:*、ticker:*、exchange:*）。
支持的字段
-
ticker（支持通配符*） -
isin -
title -
summary -
content -
openfigi -
exchange（支持通配符*）- 所有交易所均采用 MIC（市场标识码）标准。支持的代码包括：
ASEX、BVCA、BVMF、DSMD、HSTC、XSTC、MISX、NEOE、PFTS、ROCO、XADS、XAMM、XAMS、XASX、XBAH、XBEL、XBEY、XBKK、XBOG、XBOM、XBOT、XBRA、XBRU、XBSE、XBUD、XBUE、XBUL、XCAS、XCNQ、XCOL、XCSE、XCYS、XDAR、XDFM、XDHA、XDUS、XETR、XFKA、XFRA、XGHA、XHAM、XHEL、XHKG、XICE、XIDX、XIST、XJAM、XJSE、XKAR、XKAZ、XKLS、XKOR、XKUW、XLIM、XLIS、XLIT、XLJS、XLUS、XLUX、XMAL、XMAU、XMEX、XMIL、XMSW、XMUN、XNAI、XNAM、XNAS、XNGM、XNGO、XNSA、XNSE、XNYS、XASE、XOSL、XPAR、XPHS、XPRA、XRIS、XSAP、XSAU、XSES、XSCA、XSGO、XSHE、XSHG、XKRX、XSTU、XSWX、XTAE、XTAI、XTAL、XTSE、XTSX、XTUN、XUBS、XUGA、XWAR、XWBO、XZAG、XZIM、XSTO、OTCM、BMEX、XDUB、XJPX、BCXE、XPAE、XLON、XMUS、XNZE、XCAI、XBRV
- 所有交易所均采用 MIC（市场标识码）标准。支持的代码包括：
-
country- 使用 ISO 3166-1 alpha-2 国家/地区代码按公司所在国家/地区过滤（例如
US、GB、DE、JP、CN、FR、CA、AU、IN、BR等）
- 使用 ISO 3166-1 alpha-2 国家/地区代码按公司所在国家/地区过滤（例如
-
category- 按文章类别过滤。可能的值：
markets、economy、business、politics、geopolitics、regulation、technology、energy、commodities、crypto、health、climate、security
- 按文章类别过滤。可能的值：
-
source（支持通配符*）
通配符支持
通配符 * 允许您在查询中明确包含所有来源、股票代码或交易所。当您希望确保广泛覆盖，或与其他过滤器组合时，这尤其有用。
示例：
query=source:*
返回来自所有可用来源的文章。
query=ticker:* country:US
返回有关美国公司任意股票代码的文章。
query=exchange:* -crypto
返回来自所有交易所的文章，排除加密货币内容。
字段过滤示例
在 API 测试器中试用，了解其工作原理并轻松创建您自己的复杂查询。
按精确来源过滤：
query=source:www.some-source.de
排除某个来源：
query=-source:www.some-source.de
要求特定股票代码并排除某个来源：
query=ticker:AAPL -source:www.some-source.de
查找内容提及 “earnings” 且交易所为 NASDAQ 的结果：
query=content:earnings exchange:nasdaq
按特定国家/地区的公司过滤：
query=country:US
查找关于德国公司的新闻，排除 Schulden：
query=country:DE -Schulden
组合国家/地区和股票代码过滤：
query=country:US ticker:NVD
将字段过滤与普通搜索组合：
query="quarterly report" source:www.some-source.com -crypto
布尔运算符
注意：词语默认以 AND 连接，除非您想与 OR 或 NOT 组合，否则无需显式使用 AND。
完全支持 AND / OR / NOT 逻辑：
query=stock AND google
query=amazon OR google
query=market AND NOT bitcoin
使用括号进行分组： 组合逻辑表达式以实现高级过滤。
query=("Elon Musk") AND (twitter OR tesla)
与通配符组合以实现强大的查询：
query=ticker:* AND (country:US OR country:GB) -crypto
query=source:* exchange:XNAS
💡 高级用户提示
- 字段过滤器支持
+和-表示必需值和排除值。 - 通配符
*可与source、ticker和exchange字段一起使用，以匹配所有值。 - 您可以组合多个字段和关键字以实现高度精准的查询。
AND、OR、NOT等布尔运算符不区分大小写。- 括号
()有助于在复杂查询中控制优先级。 - 在多词短语两侧使用双引号
"以避免部分匹配。
结论 —— 组合一切
示例：想要关于特斯拉（ticker:TSLA）、来自可信来源、且与加密货币无关的新闻？
query=+ticker:TSLA -crypto AND (+source:www.bloomberg.com OR +source:www.reuters.com)
示例：想要来自 Bloomberg 的关于特斯拉（ticker:TSLA）或苹果（ticker:AAPL）的新闻？
query=source:www.bloomberg.com AND ticker:TSLA OR source:www.bloomberg.com AND ticker:APPL
示例：想要关于在 NASDAQ 上市的美国公司、排除加密货币内容的新闻？
query=country:US exchange:XNAS -crypto
示例：想要关于欧洲科技公司（德国、法国或英国）且提及财报的新闻？
query=earnings AND (country:DE OR country:FR OR country:GB)
示例：想要来自所有来源的所有与股票代码相关的新闻，排除加密货币？
query=ticker:* source:* -crypto
在 API 测试器中试用，了解其工作原理并轻松创建您自己的复杂查询。
原始 WebSocket 查询字段
原始 WebSocket 支持针对其简化数据模型量身定制的字段级过滤器的子集。与增强版 WebSocket 和 REST API 不同，原始 WebSocket 不支持股票代码、交易所或公司相关的字段过滤器。
支持的字段
source- 按文章来源域名过滤title- 按文章标题内容过滤summary- 按文章摘要内容过滤
示例
按标题内容过滤：
query=title:Nvidia
组合标题和摘要过滤器：
query=summary:earnings +title:Tesla
按来源过滤并排除关键字：
query=source:www.reuters.com -crypto
使用布尔运算符组合多个字段过滤器：
query=title:Apple AND summary:revenue
注意： 标准查询运算符（
+、-、AND、OR、NOT、括号和双引号）均可与原始 WebSocket 字段过滤器一起使用。
需要帮助？
如果您感到困惑、有疑问，或发现有改进的空间，请随时与我们联系。我们期待您的来信，并助您借助 finlight.me API 取得成功。