Skip to Content
GrowSocialelion API
Read endpoints

Estimate a series

Cost of a series BEFORE anything is drafted or generated: the 3 options with provider USD and credits per episode and in total, the $3 per-video cap, th...

GET | POST /api/v1/estimate_series · MCP tool estimate_series · scope read

Cost of a series BEFORE anything is drafted or generated: the 3 options with provider USD and credits per episode and in total, the $3 per-video cap, the brand's monthly cap and whether the workspace's credits cover it (if not: buy a credit pack in the app). Saves nothing, costs nothing.

Scope. Read your own brand data: posts, metrics, runs, the audit trail, the plan, stored mentions and trends. Free, unless you ask a billed network for a fresh read. This endpoint never costs credits.

Arguments

NameTypeRequiredDescription
topicstringYesWhat the series is about.
nichestringYesThe brand's niche, e.g. 'developer tools'.
brandTypestringNoe.g. saas, creator, local clinic.
mixobjectNoHow many of each kind. Default: 5 videos.
platformsstring[]NoPlatform ids from get_capabilities.
tier"lean" | "standard" | "premium"Nolean = voice + motion design; standard/premium add AI b-roll.
episodesobject[]NoYour own drafts, one per episode in mix order. Omitted = GSE drafts them (costs model credits).
templateId"x-in-100-seconds" | "build-x-in-60s" | "build-your-own-x" | "revenue-number-story" | "day-n-challenge" | "test-you-can-do-now" | "please-dont-get-x" | "before-after" | "locked-numbered-series"No'Make it like this': one of the 9 reference formats (structure, pacing, captions, visual style; some add a three.js accent). See list_media_options kind 'format'. Omitted = the agent picks the format.

Request

curl -X POST https://growsocialelion.com/api/v1/estimate_series \
  -H "Authorization: Bearer gse_mcp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic":"string","niche":"string"}'

Response

200 with the tool's answer. The shape below is generated from the output schema; real answers can carry more fields.

{
  "status": "string",
  "reason": "string"
}

Errors use the shared body. See Errors. The full schema is in the API reference.