Start with a task
Frame the workflow around one job such as a visibility snapshot, creator shortlist, or travel demand signal.
Docs
Docs for agent builders
Use ChinaMarketing.ai primitives inside agent workflows, orchestration layers, and machine-paid execution paths.
Updated hourly on supported routes Low-latency request paths 1h to 24h cache defaults
Map the task to primitives
Use one endpoint for quick checks or combine multiple routes when the workflow needs richer context.
Return structured outputs
Feed rankings, snapshots, trend series, and enrichment layers into orchestration and UI decisions.
Integration patterns
Use the same primitives in different orchestration shapes
Single-call tools
For agents that need one narrow intelligence action with a simple price and response contract.
Multi-call workflows
For systems that stitch together multiple primitives into one branded or task-specific output.
Scheduled monitoring
For repeated checks on a brand, route, creator set, or category over time.
Budget-aware execution
For flows that need predictable per-task cost logic before each agent run.
Recommended starting workflows
Start with a repeatable workflow, then drop into deeper docs as needed
Brand visibility
Combine trends, sentiment, and weekly brand snapshots for a reusable visibility summary.
Travel movement
Use flights and spend signals to build destination monitoring and movement summaries.
Creator discovery
Start with shortlist generation, then add rankings to compare and monitor creator momentum.
Category monitoring
Layer trends, topic rankings, and category snapshots for ongoing market signal checks.
Real response example
China visibility snapshot
A typical agent task can return a compact object that is easy to route into UI, reasoning, or monitoring logic.
Output
{
"brand": "X",
"visibility_score": 72,
"trend_direction": "rising",
"top_platform": "RED",
"sentiment": "positive",
"key_topics": ["luxury skincare", "anti-aging"]
} API reference bridge
Need schema-level detail, parameter definitions, and endpoint reference?
Use the core developer docs for route-level request and response examples, anchors, pricing, and payment mechanics.
Response design guidance
Use ranking outputs for routing and prioritisation.
Use trend outputs for summarisation and movement checks.
Use snapshots for UI modules, reporting, and planning context.
Use multiple calls when the workflow needs confidence and enrichment.