Skip to Content
GrowSocialelion API
Drafts endpoints

Propose a series

Propose a SERIES for the brand: posts, an article and/or short 9:16 videos on one topic, with one shared design kit.

POST /api/v1/propose_series · MCP tool propose_series · scope drafts + spend

Propose a SERIES for the brand: posts, an article and/or short 9:16 videos on one topic, with one shared design kit. Returns 3 options (design kit, real preview videos from the example library, cost estimate per episode and for the whole series, the $3 per-video cap and the brand's cap) and saves the top option (or kitId) as a PROPOSED series with every episode drafted and cross-linked ('Part N of M', UTM). Generates no video and publishes nothing. A human approves the whole series once in the app. Send your own `episodes` to skip GSE's drafting call. Pass `templateId` (list_media_options kind 'format') to make it like one of the 9 reference formats: its beats, pacing, captions and look, some with a three.js accent (no extra provider cost).

Scope. Save drafts, articles and series proposals to the Inbox, and withdraw your own drafts. Nothing publishes. Every call costs credits, so the key also needs spend.

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.
kitId"terminal-dev" | "bold-kinetic" | "clean-explainer"NoDesign kit; omitted = the best-ranked option.
episodesobject[]NoYour own drafts, one per episode in mix order. Omitted = GSE drafts them (costs model credits).
titlestringNo
stemstringNoLocked caption stem shown on every episode.
siteUrlstringNoBrand page every episode links to (UTM added per part).
networksobject[]NoYour own reason per network, one sentence each, shown to the person on the series page. Omitted = GSE proposes every connected network that takes the part kinds.
videoLength"standard" | "short"NoVideo script length when GSE drafts: standard ≈ 45 s (default), short ≈ 15 s (under ~300 characters of voice).
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/propose_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",
  "seriesId": "string"
}

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