GateData.AI

社交帖检索

搜索指定标的相关社交帖。

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

可查询数据

返回数据
指定标的相关社交帖
市场覆盖
Crypto；X
查询粒度
每次返回一组帖子，可按标的、关键词、平台或时间筛选

认证

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

请求参数

querystringquery示例NVDA可选

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

tickerstringquery示例NVDA可选

资产代码。

marketMarketquery示例us_equity可选

标准市场代码。

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

起始时间。

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

结束时间。

platformenumquery示例x可选

Social platform (e.g. x).

listing_idsstring[]query示例listing_nvda_xnas可选

Listing identifiers (e.g. listing_nvda_xnas).

limitintegerquery示例1可选

返回条数。

响应

dataobject
posts[]object[]

UGC 帖子（post_id、handle、name、author_ref_id、platform、summary、sentiment、engagement_count、entity_ids/asset_ids/listing_ids/chain 等）

post_idstring示例2089250274640900110

UGC 帖子 id

platformstring示例x

来源平台（如 x）

handlestring | null

作者 handle（未知为 null）

namestring | null

作者展示名（未知为 null）

author_ref_idstring示例author_5441aa8fe441

稳定作者引用 id

summarystring示例美股财报季临近尾声，焦点转向13F持仓披露与并购/审批催化剂：伯克希尔Q2 13…

帖子摘要

sentimentstring示例neutral

帖子情绪（如 neutral）

engagement_countinteger示例0

互动计数

quality_tierstring

质量档位（可为空字符串）

low_confidenceboolean示例false

低置信匹配时为 true

confidence_reasonstring | null

低置信原因（有则返回）

match_reasonstring示例命中标的代码、检索文本

命中检索的原因

source_published_atdatetime示例2026-08-17T15:25:06.000Z

来源发布时间

source_urlstring示例https://x.com/i/web/status/2089250274640…

来源 URL

asset_ids[]string[]

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

entity_ids[]string[]

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

instrument_ids[]string[]

交易工具标识数组，标识股票、现货交易对或合约等具体交易产品

listing_ids[]string[]

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

chain[]string[]

帖子上的链标签

mentions[]string[]示例GOOGL

帖子中抽出的 ticker / 名称提及（可选）

data_statusDataStatus示例ok

ok / partial / no_data

empty_reasonstring | null

空结果 / 部分缺失原因码

errorobject | null

错误对象。

external_refs[]object[]

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

lineage_refs[]object[]

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

source_refs[]object[]

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

metadataobject

响应状态与解析信息容器

entitlementsobject

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

endpointstring示例signals.ugc_search

授权端点 id（如 signals.sentiment）

evidence_fanout_levelstring示例custom

证据展开权限等级

field_levelstring示例custom

字段级权限

object_resolution_levelstring示例L3

对象解析权限（如 L3）

crypto_social_funnelobject

加密社交漏斗计数：os_hits / after_social / after_pipeline

os_hitsinteger示例300

社交来源过滤前的命中条数

after_socialinteger示例5

社交来源过滤后的条数

after_pipelineinteger示例5

完整管道后的条数

data_statusDataStatus示例ok

就绪状态镜像

resolution_statusResolutionStatus示例resolved_local

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

resolved_tickerstring示例BTC

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

resolved_marketstring示例crypto

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

limitations[]string[]示例crypto_social_best_effort

已知数据限制数组

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

对象或响应最近更新时间

resolution_reasonstring示例upstream_error

对象解析结果的原因码

object_refs[]object[]

统一对象引用数组

错误与降级

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。