v5

OpenAPI 3.0.02026-08-034760291.5 KB

Generate Article

Generate a structured, type-specific article outline

Generates the structured outline for an article (listicle/guide/comparison/review/news) from a title + keywords + optional prompt insights and competitor URLs. The outline MUST be produced by this tool — its shape is type-specific and strict. Returns { outline, auto_selections, competitive_analysis, optimization_scope }. To create an article from it, pass the WHOLE returned object as articleOutline.generateOutlineResponse to create_article (or just use the one-shot generate_article).

get/v3/generate-article/generate-outline/

Query parameters

titlestring required

Article title (required).

typestring

Article type: listicle | guide | comparison | review | news. Defaults to listicle.

content_article_typestring

pillar | cluster (omit for a standalone post).

string

string[]

Primary target keywords.

string

string[]

Secondary keywords.

prompt_insights_jsonstring

JSON-stringified array of prompt-insight rows the article should answer.

article_topicstring

Topic cluster the article belongs to.

string

string[]

Up to 5 competitor article URLs to inform competitive analysis.

lengthstring

Target word count: 'auto', a number like '1900', or a label.

tonestring

audiencestring

countrystring

languagestring

Response

Default Response