Typical call pattern
One call for freshness or summary checks. Two to three calls for market context. Four or more calls for a destination workflow bundle.
Capabilities
Capabilities for agent workflows
The platform exposes narrow intelligence primitives that can be used individually or composed into higher-value agent tasks.
Updated hourly on supported routes Low-latency request paths 1h to 24h cache defaults
How to read this page
Each section maps one workflow family to concrete routes, typical call patterns, output styles, and indicative cost posture.
Use it as the bridge between commercial task framing and the deeper endpoint reference in developer docs.
Travel intelligence
For agents that need travel demand, route movement, growth, and market context tied to Chinese outbound behaviour.
Use this when
Evaluating destination momentum
Comparing travel markets
Supporting hospitality or DMO workflows
Evaluate travel demand by market Compare route momentum across destinations Generate a destination movement snapshot
Output style
Summary snapshotComparative movementTime-series signal
Indicative cost posture
From $0.03 for freshness checks, with richer destination snapshots typically landing in the low-dollar range.
Typical agent flow
1. Input: destination or market question
2. Call: flights and spend primitives
3. Filter: month, destination, comparison set
4. Output: movement snapshot or prioritisation signal
Recommended endpoints
Price
Cache posture
/v1/market-data/flights/months
List the available source months for the flight-arrivals dataset.
$0.03
6 hour default cache
/v1/market-data/flights/summary
Latest or month-specific destination flight summary with route, seat, passenger, and concentration metrics.
$0.10
6 hour default cache
/v1/market-data/flights/trend
Monthly scheduled-flight trend series for a destination.
$0.10
6 hour default cache
/v1/market-data/flights/top-routes
Top departure cities feeding a destination in a given month.
$0.10
6 hour default cache
/v1/market-data/flights/ranking
Destination ranking by estimated passengers for a given or latest month.
$0.10
6 hour default cache
/v1/market-data/flights/growth
Fastest-growing destinations by month-over-month passenger trend.
$0.10
6 hour default cache
/v1/market-data/flights/aggregate
Aggregate multiple destinations into one destination-cluster summary for route planning or market grouping.
$0.16
6 hour default cache
/v1/market-data/spend/months
List the available source months for the destination spend dataset.
$0.03
6 hour default cache
/v1/market-data/spend/countries
List supported countries in the spend dataset, optionally scoped to a specific month.
$0.03
6 hour default cache
/v1/market-data/spend/summary
Latest or month-specific destination spend summary for a country, including key metrics, breakdown highlights, and data-quality context.
$0.10
6 hour default cache
/v1/market-data/spend/trends
Country-level destination spend trend pack for downstream planning and prioritization.
$0.10
6 hour default cache
/v1/market-data/spend/series
Time series for a supported destination spend metric such as total cards or selected average spend measures.
$0.10
6 hour default cache
Brand visibility
For agents that need to evaluate how visible, discussed, and competitively positioned a brand is across China-facing signals.
Use this when
Evaluating discoverability
Comparing brands
Monitoring sentiment shifts
Generate a China visibility snapshot Track trend and sentiment shifts Benchmark brand presence against category signals
Typical call pattern
Use one trend route for lightweight checks, then layer sentiment and snapshots when a decision needs stronger context.
Output style
Summary snapshotComparative movementEnrichment layer
Indicative cost posture
Entry-point routes start at $0.08, while full visibility snapshots combine a few higher-value signals.
Typical agent flow
1. Input: brand or category
2. Call: trends, sentiment, and snapshot routes
3. Filter: platform, timeframe, category
4. Output: visibility summary with directional context
Recommended endpoints
Price
Cache posture
/v1/china/trends
Trend momentum, related keywords, themes, and content-angle summaries for a keyword or topic, with confidence tied to the strength of the retrieved evidence.
$0.08
1 hour default cache
/v1/china/trends/douyin
Douyin-specific trend discovery with a forced Douyin retrieval lane and narrower Douyin-first query shaping.
$0.08
1 hour default cache
/v1/china/trends/wechat
WeChat-specific trend discovery with a forced WeChat retrieval lane and narrower WeChat-article query shaping.
$0.08
1 hour default cache
/v1/china/trends/red
RED-specific trend discovery using the current RED-proxy evidence posture with RED-focused query shaping.
$0.08
1 hour default cache
/v1/china/sentiment
Localized narrative and sentiment framing for brands, destinations, products, and topics.
$0.15
6 hour default cache
/v1/signals/brands/:brand_slug/snapshot
Derived weekly brand snapshot for a category, including visibility scoring, contributing rank positions, and freshness metadata.
$0.40
24 hour default cache
/v1/signals/categories/:category_slug/snapshot
Weekly category overview that blends top creators, topics, and brands for the latest or requested published release.
$0.40
24 hour default cache
Creator discovery
For agents that need ranked creator inputs, discovery signals, and shortlist support for campaign or brand research workflows.
Use this when
Scoping a campaign brief
Filtering by creator fit
Monitoring shortlist movement
Find creators for a campaign brief Generate a shortlist by signal strength Monitor creator movement over time
Typical call pattern
A single KOL call works for brief-driven discovery. Add rankings when the workflow needs comparison, monitoring, or shortlist validation.
Output style
Ranked entitiesSummary snapshotEnrichment layer
Indicative cost posture
Discovery can start with one premium shortlist call, then expand with lower-cost monitoring inputs.
Typical agent flow
1. Input: campaign brief
2. Call: KOL plus creator rankings
3. Filter: category, engagement, platform fit
4. Output: shortlist-ready creator set
Recommended endpoints
Price
Cache posture
/v1/china/kols
Focused KOL and KOC shortlists with fit scoring, engagement-quality estimates, and recommendation summaries.
$0.45
24 hour default cache
/v1/signals/creators/rankings
Weekly creator rankings for a supported category and rank type, suitable for monitoring breakout presence and creator momentum.
$0.18
24 hour default cache
Topic and category signals
For agents that need to identify rising topics, category movement, and structured signal changes relevant to China demand and content planning.
Use this when
Tracking category movement
Watching content shifts
Supporting planning workflows
Identify rising topics in a category Monitor content and search signal shifts Support planning and insight generation workflows
Typical call pattern
Start with topic rankings or a single trends route, then add category snapshots when the workflow needs broader market context.
Output style
Ranked entitiesTime-series signalComparative movement
Indicative cost posture
Most signal-monitoring calls stay compact and predictable, with weekly snapshots adding a higher-confidence layer.
Typical agent flow
1. Input: category or topic focus
2. Call: rankings, trends, and snapshots
3. Filter: rank type, timeframe, category
4. Output: topic movement and category summary
Recommended endpoints
Price
Cache posture
/v1/signals/topics/rankings
Weekly topic rankings for a supported category and topic rank type, returning a structured snapshot of emerging or high-volume themes.
$0.18
24 hour default cache
/v1/signals/categories/:category_slug/snapshot
Weekly category overview that blends top creators, topics, and brands for the latest or requested published release.
$0.40
24 hour default cache
/v1/china/trends
Trend momentum, related keywords, themes, and content-angle summaries for a keyword or topic, with confidence tied to the strength of the retrieved evidence.
$0.08
1 hour default cache
/v1/china/trends/red
RED-specific trend discovery using the current RED-proxy evidence posture with RED-focused query shaping.
$0.08
1 hour default cache
/v1/china/trends/douyin
Douyin-specific trend discovery with a forced Douyin retrieval lane and narrower Douyin-first query shaping.
$0.08
1 hour default cache
/v1/china/trends/wechat
WeChat-specific trend discovery with a forced WeChat retrieval lane and narrower WeChat-article query shaping.
$0.08
1 hour default cache
Composed workflows
Higher-value tasks emerge when multiple primitives are chained together
Brand snapshot workflow
Structured brand visibility summary Trends Sentiment Brand snapshot
Typical flow: input task, call the listed routes, apply workflow filters, and return one decision-ready output object.
Travel movement workflow
Destination demand snapshot Flights summary Top routes Growth Spend trends
/v1/market-data/flights/summary /v1/market-data/flights/top-routes /v1/market-data/flights/growth /v1/market-data/spend/trends
Typical flow: input task, call the listed routes, apply workflow filters, and return one decision-ready output object.
Creator scouting workflow
Shortlist-ready creator intelligence KOLs Creator rankings Topic rankings
Typical flow: input task, call the listed routes, apply workflow filters, and return one decision-ready output object.
Category signal workflow
Category movement summary Category snapshot Topic rankings Trends
Typical flow: input task, call the listed routes, apply workflow filters, and return one decision-ready output object.