Briefs

Parse content briefs into structured article parameters

Parse a content brief

post

Parse a content brief (any format: formal document, bullet points, or narrative) into structured article generation parameters. Returns extracted outline, keywords, tone, audience, content gaps, and instructions that can be used with POST /v1/contents.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

contentstringRequired

The raw content brief text to parse (minimum 50 characters)

modelstringOptional

AI model for parsing (e.g. gpt-5-mini, claude-sonnet-4-5). Defaults to team default.

Responses

200

Brief parsed successfully

application/json

titlestringOptional

Target article title or H1

target_keywordstringOptional

Primary target keyword

secondary_keywordsstring[]Optional

Secondary keywords

word_countintegerOptional

Target word count

tonestringOptional

Tone/style directive

target_audiencestringOptional

Target audience description

article_typestring · enumOptionalPossible values:

content_gapsstring[]Optional

Required differentiation points

paa_questionsstring[]Optional

People Also Ask questions

extra_instructionsstringOptional

Catch-all for other editorial rules and requirements

post

/v1/briefs

HTTPcURLJavaScriptPython

POST /v1/briefs HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "content": "text",
  "model": "text"
}

200

Brief parsed successfully

{
  "title": "text",
  "target_keyword": "text",
  "secondary_keywords": [
    "text"
  ],
  "word_count": 1,
  "tone": "text",
  "target_audience": "text",
  "article_type": "general",
  "outline": [
    {
      "level": 1,
      "title": "text",
      "instructions": "text"
    }
  ],
  "content_gaps": [
    "text"
  ],
  "paa_questions": [
    "text"
  ],
  "extra_instructions": "text"
}