8f92b00b75d6

OpenAPI 3.0.02026-08-094780295.7 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).

type'listicle' | 'comparison' | 'news' | 'review' | 'guide'

Article type. Defaults to listicle. Selects the outline structure.

content_article_type'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