GateData.AI

News / content search

Search structured market news.

GET/api/v1/news/search
Domain
Events, News, Sentiment & Signals
Level
Asset or keyword
MCP tool
events_news_query (task=content_search)

Available data

Returns
Structured market news
Market coverage
Crypto and US equities
Query granularity
Each query returns a list of items; filter by ticker, keyword, or time. Full articles are not returned

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

querystringqueryExampleNVDAoptional

Search text used to identify the object you want.

tickerstringqueryExampleNVDAoptional

Ticker when used with market.

marketMarketqueryExampleus_equityoptional

us_equity | hk_equity | kr_equity | uk_equity | jp_equity | crypto

listing_idsstring[]queryExamplelisting_nvda_xnasoptional

Listing identifiers (e.g. listing_nvda_xnas).

sectorstring[]queryExampleElectronic Technologyoptional

Sector filters.

industrystring[]queryExampleSemiconductorsoptional

Industry filters.

event_categorystring[]queryExamplecompany_financialoptional

Event category filters.

impact_directionstring[]queryExamplebullishoptional

Impact direction filters.

start_timedatetimequeryExample2026-07-01T00:00:00Zoptional

Start time (ISO 8601).

end_timedatetimequeryExample2026-07-31T23:59:59Zoptional

End time (ISO 8601 UTC).

limitintegerqueryExample10optional

Max rows to return (up to 1000).

Response

dataobject
items[]object[]

News items (item_id, title, summary, content_excerpt, publish_time_utc, impact_direction, market[], chain, …)

item_idstringExample2089092501864956342

News item id

titlestringExampleother

Title / category label as returned

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

Item summary

content_excerptstringExampleRT @EconomPic: Strategy has a ~$10B unre…

Longer excerpt when present

publish_time_utcdatetimeExample2026-08-17T04:55:59.000Z

Publish time (UTC)

impact_directionstringExamplebearish

Impact direction (e.g. mixed)

importance_levelstringExamplemedium

Importance (e.g. medium)

event_categorystringExamplemarket

Event category

match_reasonstringExample命中检索文本

Why this item matched the query

source_namestring | null

Source name when known

original_urlstring | null

Original URL when known

source_credibility_scorenumberExample0

Source credibility score

tag_confidencenumberExample0.8

Tag confidence (0–1)

market[]string[]Examplecrypto

Markets tagged on the item

chain[]string[]ExampleBitcoin

Chains tagged on the item

industry[]string[]

Industry tags

sector[]string[]Exampleothers

Sector tags

asset_ids[]string[]Exampleasset_btc

Linked asset ids

entity_ids[]string[]

Linked entity ids

listing_ids[]string[]

Linked listing ids

event_tags[]string[]Exampletreasury

Event classification tags

mentions[]string[]ExampleStrategy

Ticker or name mentions

totalnumberExample5

Item count

data_statusDataStatusExampleok

ok / partial / no_data

empty_reasonstring | null

Empty / partial reason code

errorobject | null

Error object; null on success

external_refs[]object[]

External, lineage, and upstream source references

lineage_refs[]object[]

External, lineage, and upstream source references

source_refs[]object[]

External, lineage, and upstream source references

metadataobject

Response status and resolution information

entitlementsobject

Endpoint and field / resolution / evidence entitlement levels

endpointstringExamplenews.search

Entitled endpoint id (e.g. signals.sentiment)

evidence_fanout_levelstringExamplecustom

Evidence fan-out entitlement level

field_levelstringExamplecustom

Field-level entitlement

object_resolution_levelstringExampleL3

Object-resolution entitlement (e.g. L3)

data_statusDataStatusExampleok

Mirror of readiness in metadata

resolution_statusResolutionStatusExampleresolved

Resolver status and pinned ticker / market when present

resolved_tickerstringExampleBTC

Resolver status and pinned ticker / market when present

resolved_marketstringExamplecrypto

Resolver status and pinned ticker / market when present

limitations[]string[]

Known data limitations

updated_atdatetime | stringExample2026-08-17T08:25:17Z

Most recent object or response update time

object_refs[]object[]

Unified object references

typeObjectRefTypeExampleasset

Object reference type

idstringExampleasset_btc

Canonical object identifier

entity_idstringExampleentity_rd_2

Canonical entity identifier

asset_idstringExampleasset_btc

Canonical asset identifier

resolved_fromstringExampleprimary_asset

Input used to resolve the object

resolution_confidencestringExample1

Object resolution confidence

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.