GateData.AI

新闻检索

搜索结构化市场新闻。

GET/api/v1/news/search
数据域
事件、新闻、舆情与信号
解析层级
资产或关键词
MCP 工具
events_news_query (task=content_search)

可查询数据

返回数据
结构化市场新闻
市场覆盖
Crypto、美股
查询粒度
每次返回一组条目，可按标的、关键词或时间筛选；不返回原文全文

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

请求参数

querystringquery示例NVDA可选

查询关键词、代码或名称。

tickerstringquery示例NVDA可选

资产代码。

marketMarketquery示例us_equity可选

标准市场代码。

listing_idsstring[]query示例listing_nvda_xnas可选

Listing identifiers (e.g. listing_nvda_xnas).

sectorstring[]query示例Electronic Technology可选

Sector filters.

industrystring[]query示例Semiconductors可选

Industry filters.

event_categorystring[]query示例company_financial可选

Event category filters.

impact_directionstring[]query示例bullish可选

Impact direction filters.

start_timedatetimequery示例2026-07-01T00:00:00Z可选

起始时间。

end_timedatetimequery示例2026-07-31T23:59:59Z可选

结束时间。

limitintegerquery示例10可选

返回条数。

响应

dataobject
items[]object[]

新闻条目（item_id、title、summary、content_excerpt、publish_time_utc、impact_direction、market[]、chain 等）

item_idstring示例2089092501864956342

新闻条目 id

titlestring示例other

标题 / 返回的分类标签

summarystring示例Strategy（原MicroStrategy）持有约84万枚比特币，未实现亏损…

摘要

content_excerptstring示例RT @EconomPic: Strategy has a ~$10B unre…

正文摘录（有则返回）

publish_time_utcdatetime示例2026-08-17T04:55:59.000Z

发布时间（UTC）

impact_directionstring示例bearish

影响方向（如 mixed）

importance_levelstring示例medium

重要度（如 medium）

event_categorystring示例market

事件类别

match_reasonstring示例命中检索文本

命中检索的原因

source_namestring | null

来源名称（未知为 null）

original_urlstring | null

原文 URL（未知为 null）

source_credibility_scorenumber示例0

来源可信度分数

tag_confidencenumber示例0.8

标签置信度（0–1）

market[]string[]示例crypto

条目上的市场标签

chain[]string[]示例Bitcoin

条目上的链标签

industry[]string[]

行业标签

sector[]string[]示例others

板块标签

asset_ids[]string[]示例asset_btc

资产标识数组，标识股票、加密资产等资产对象

entity_ids[]string[]

主体标识数组，标识公司、项目方或协议等主体

listing_ids[]string[]

交易场所挂牌标识数组，标识交易品种在特定交易场所的挂牌记录

event_tags[]string[]示例treasury

事件分类标签

mentions[]string[]示例Strategy

代码或名称提及

totalnumber示例5

条目数量

data_statusDataStatus示例ok

ok / partial / no_data

empty_reasonstring | null

空结果 / 部分缺失原因码

errorobject | null

错误对象。

external_refs[]object[]

外部引用、血缘引用与来源引用

lineage_refs[]object[]

外部引用、血缘引用与来源引用

source_refs[]object[]

外部引用、血缘引用与来源引用

metadataobject

响应状态与解析信息容器

entitlementsobject

端点及字段 / 解析 / 证据权限等级

endpointstring示例news.search

授权端点 id（如 signals.sentiment）

evidence_fanout_levelstring示例custom

证据展开权限等级

field_levelstring示例custom

字段级权限

object_resolution_levelstring示例L3

对象解析权限（如 L3）

data_statusDataStatus示例ok

元数据中的就绪状态

resolution_statusResolutionStatus示例resolved

解析状态与钉住的 ticker / market（有则返回）

resolved_tickerstring示例BTC

解析状态与钉住的 ticker / market（有则返回）

resolved_marketstring示例crypto

解析状态与钉住的 ticker / market（有则返回）

limitations[]string[]

已知数据限制数组

updated_atdatetime | string示例2026-08-17T08:25:17Z

对象或响应最近更新时间

object_refs[]object[]

统一对象引用数组

typeObjectRefType示例asset

对象引用类型

idstring示例asset_btc

对象标识，标识 type 指定的具体对象

entity_idstring示例entity_rd_2

主体标识，标识公司、项目方或协议等主体

asset_idstring示例asset_btc

资产标识，标识股票、加密资产等资产对象

resolved_fromstring示例primary_asset

对象解析所用输入来源

resolution_confidencestring示例1

对象解析置信度

错误与降级

200
assets_resolve 名称多命中；从 data[] 候选确认。
200
对象已解析但无可用数据；empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效，或行情 listing 多命中；歧义响应含 required_params + candidates。
401
缺少 API Key，或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在；数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限；body 返回 retry_after，响应头同步返回 Retry-After。