Developers
Build with the live state of any market.
One call returns a calibrated, actionable state your app or agent can act on.
GET · application/json
GET /v1/objects/demand:facial-spf/state
{
"object": "demand:facial-spf",
"state": 73,
"verdict": "watch",
"trajectory": [58, 63, 69, 73],
"driver": "rising search volume + repeat-purchase intent",
"move": "Brief 2 creators before the UV peak",
"settles_on": "purchase window + 14 days",
"calibration": "held 7 of last 10"
}Quickstart
Live in three steps
1
Get a key
shell
# create a key in the dashboard, then: export RECOMMEND_API_KEY=rcmd_live_...
2
Query an object’s state
curl https://api.recommend.co/v1/objects/demand:facial-spf/state \ -H "Authorization: Bearer $RECOMMEND_API_KEY"
3
Register the MCP server
mcp.json
{
"mcpServers": {
"recommend": {
"url": "https://mcp.recommend.co",
"apiKey": "rcmd_..."
}
}
}Core concepts
Three ideas, one loop
Object
The thing you follow — a market, category, account, or release.
State
Its calibrated score, verdict, trajectory, driver, and move.
Query
Read that state any time — over HTTP or MCP, human or agent.
Developers
Coming soon
We're putting the finishing touches on this section. Try the live playground in the meantime.
Try the playground