GateData.AI

Social / UGC search

Search social posts related to a ticker.

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

Available data

Returns
Social posts related to a ticker
Market coverage
Crypto on X
Query granularity
Each query returns a list of posts; filter by ticker, keyword, platform, or time

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

fromdatetimequeryExample2026-07-01T00:00:00Zoptional

Start time (ISO 8601).

todatetimequeryExample2026-07-31T23:59:59Zoptional

End time (ISO 8601 UTC).

platformenumqueryExamplexoptional

Social platform (e.g. x).

listing_idsstring[]queryExamplelisting_nvda_xnasoptional

Listing identifiers (e.g. listing_nvda_xnas).

limitintegerqueryExample1optional

Max rows to return (up to 1000).

Response

dataobject
posts[]object[]

UGC posts (post_id, handle, name, author_ref_id, platform, summary, sentiment, engagement_count, entity_ids/asset_ids/listing_ids/chain, …)

post_idstringExample2089250274640900110

UGC post id

platformstringExamplex

Source platform (e.g. x)

handlestring | null

Author handle when known

namestring | null

Author display name when known

author_ref_idstringExampleauthor_5441aa8fe441

Stable author ref id

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

Post summary

sentimentstringExampleneutral

Post sentiment (e.g. neutral)

engagement_countintegerExample0

Engagement count

quality_tierstring

Quality tier token (may be empty)

low_confidencebooleanExamplefalse

True when the match is low-confidence

confidence_reasonstring | null

Reason for low confidence when present

match_reasonstringExample命中标的代码、检索文本

Why this post matched the query

source_published_atdatetimeExample2026-08-17T15:25:06.000Z

Source publish time

source_urlstringExamplehttps://x.com/i/web/status/2089250274640…

Source URL

asset_ids[]string[]

Linked asset ids

entity_ids[]string[]

Linked entity ids

instrument_ids[]string[]

Linked instrument ids

listing_ids[]string[]

Linked listing ids

chain[]string[]

Chains tagged on the post

mentions[]string[]ExampleGOOGL

Optional ticker / name mentions on the post

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

endpointstringExamplesignals.ugc_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)

crypto_social_funnelobject

Crypto social pipeline counts: os_hits / after_social / after_pipeline

os_hitsintegerExample300

Hit count before social-source filters

after_socialintegerExample5

Count after social-source filter

after_pipelineintegerExample5

Count after the full pipeline

data_statusDataStatusExampleok

Mirror of readiness

resolution_statusResolutionStatusExampleresolved_local

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[]Examplecrypto_social_best_effort

Known data limitations

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

Most recent object or response update time

resolution_reasonstringExampleupstream_error

Reason code for the object-resolution outcome

object_refs[]object[]

Unified object references

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.