Upsell Funnel
Read the per-feature upsell conversion funnel — platform-admin only — via the MisarBlog API.
Returns the per-feature upsell conversion funnel: how many creators saw an upsell for a feature, started a trial, and converted to a paid plan.
Platform-admin only
This endpoint is restricted to platform administrators. A normal mbk_ key receives 403 Forbidden.
Get the upsell funnel
/upsell-funnelQuery parameters
daysintegerquerydefault: 30Look-back window in days.
featurestringqueryRestrict the funnel to a single feature slug. Omit to return all features.
Response
A funnel object keyed by feature, with per-stage counts (impressions → trial starts → conversions). The exact shape is intentionally open — treat unknown keys as additive.
curl "https://api.misar.io/blog/v1/upsell-funnel?days=30" \
-H "Authorization: Bearer mbk_ADMIN_KEY"{
"period_days": 30,
"features": [
{
"feature": "ai_titles",
"impressions": 1840,
"trial_starts": 96,
"conversions": 21
}
]
}{ "error": "Admin only" }The example response fields above are illustrative — the funnel payload is a platform-internal shape and may change. Prefer the Plan & Trial endpoints for anything you build against a normal key.
Status codes
401— Missing or invalid key403— Not a platform administrator429— Rate limit exceeded (100 req/min per key)500— Unexpected server error