Start here
Credits
Check the price of each Tool and see when your workspace spends credits.
How a call is charged
- When a charge applies, the API checks the available balance and reserves credits. An empty Outliers page skips this step.
- The Tool runs. For a fixed-price Tool the hold is already the final charge.
- When the call completes, the exact amount is captured from the hold and the remainder is released.
An unsuccessful Tool releases its unused hold. Completed actions are settled independently. A hold that is never settled expires: 10 minutes for an inline call, 2 hours for a queued job.
Paid Tools
| Tool | Price |
|---|---|
analyze_post | 10 + 4 credits per started 30 seconds (14–34) |
get_post | 2 credits |
list_outliers | 1 credit per non-empty API/MCP results page |
list_patterns | 20 credits |
list_posts | 5 credits |
save_inspo | 0 from storage; 2 credits for a successful fetch |
search_creators | 2 credits |
search_similar_creators | 2 credits |
A 41-second video costs 18 credits. Opening a saved report is free. Koo adds 2 credits per user message that reaches the model, so asking Koo to analyze that video costs 20 credits.
Outliers page browsing and static search are free. API and MCP share prices. Managing competitors and reading saved competitor results are free. A successful first competitor check costs 10 credits and subsequent checks cost 2 each. Publishing and own-channel insights use the channels included with a paid plan and cost no extra research credits.
Read your balance
get_balance is free. It returns the plan, its channel and creator limits, and three credit figures.
curl -X POST https://api.cuekoo.com/openapi/v1/tools/get_balance \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'available: credits you can spend right now, after holds.held: credits reserved by calls that are still running.used_this_period: credits captured since the current billing period started.
The same figures appear in the workspace's billing settings. A 402 response includes them in its details object, which lets an integration pause instead of retrying blindly.
Plan quotas are separate
Credits pay for Tool calls. Plans also cap channels and tracked creators; calls that would exceed a plan limit fail with feature_not_in_plan or quota_exceeded and charge nothing. See Errors for the exact status codes.