Skip to main content
GET
/
generate-article
/
generate-outline
Article Outline
curl --request GET \
  --url https://v3-api-beta.snowseo.com/snowseo/v2/generate-article/generate-outline \
  --header 'Authorization: Bearer <token>'
Get a ready-to-use article outline with headings, subheadings, and key points. The AI creates a logical structure optimized for both readers and search engines.

​
Request

​
title
string
required
The article title to generate an outline for.
​
type
string
Content type (e.g., blog, pillar).
​
content_article_type
string
Article format — e.g., how-to, listicle, comparison, guide.
​
primary_keywords
string | string[]
Primary target keywords for the article.
​
secondary_keywords
string | string[]
Secondary / supporting keywords.
​
competitor_articles
string | string[]
URLs of competitor articles for competitive analysis.
​
length
string
Target article length (e.g., short, medium, long).
​
style
string
Writing style (e.g., formal, conversational).
​
goal
string
Content goal (e.g., educate, convert, engage).
​
tone
string
Tone of the article (e.g., professional, casual, authoritative).
​
audience
string
Target audience description.
​
depth
string
Content depth (e.g., overview, deep-dive).
​
cta_intent
string
Call-to-action intent (e.g., sign-up, learn-more, purchase).
​
country
string
Target country code (e.g., US, GB).
​
language
string
Target language (e.g., en, es).

​
Response

{
  "outline": {
    "meta_information": {
        "estimated_word_count": 750,
        "reading_time_minutes": 4,
        "content_complexity": "intermediate",
        "seo_difficulty": 7.5,
        "competitive_advantage": "Comprehensive, 2025-ready, pillar-level audit coverage with actionable frameworks."
    },
    "introduction": {
        "hook": "A website audit in 2025 is no longer optional—it’s the backbone of performance, rankings, and conversions.",
        "problem_statement": "Most businesses run outdated or incomplete audits that overlook critical technical, content, and UX shifts.",
        "solution_preview": "This guide outlines the essential best practices for running a modern, comprehensive website audit.",
        "credibility_signal": "Backed by industry-leading audit methodologies and updated 2025 SEO insights.",
        "estimated_words": 100
    },
    "sections": [
      {
        "heading": "Technical Foundations: Core Website Audit Essentials",
        "level": "h2",
        "target_keywords": [
            "website audit",
            "technical audit 2025"
        ],
        "estimated_words": 140,
        "subsections": [
            {
                "heading": "Crawlability and Indexing Checks",
                "level": "h3",
                "target_keywords": [
                    "indexing audit"
                ]
            }
        ]
      }
    ],
    "conclusion": {
        "key_takeaways": [
            "Prioritize modern technical, content, UX, and reporting audits",
            "Use structured frameworks for consistent results",
            "Leverage automation for scale in 2025"
        ],
        "call_to_action": "Explore our detailed audit templates and advanced SEO guides.",
        "next_steps": "Review specialized deep-dive articles linked throughout this guide.",
        "estimated_words": 90
    },
    "additional_elements": {
        "faq_section": [
            {
                "question": "How often should you run a website audit in 2025?",
                "answer_preview": "Most businesses benefit from quarterly audits with monthly technical checks."
            }
        ]
    }
  },
  "auto_selections": {
    "content_tone": "Professional",
    "target_audience": "Startup founders, content marketers, SEO specialists, agencies, ecommerce owners"
  },
  "competitive_analysis": {
    "keyword_opportunities": [
        "website audit guide",
        "SEO audit 2025"
    ]
  },
  "optimization_scope": {
    "featured_snippet_targets": [
        {
            "question": "What is included in a website audit?",
            "format": "list"
        }
    ]
  }
}