Skip to main content
POST
Generate article title ideas
Generate ranked article title suggestions for a topic cluster. Sent as a POST with a JSON body. Pass the cluster’s name as topics. At least one of topics, keywords, or prompt is required (otherwise 400). Optional: type (listicle default, comparison, news, review, guide), count (1-20, default 8), contentArticleType (pillar or cluster), country, and language. The response is { output: { titles } }, where each title has title, target_intent, primary_keywords, relevance_score, and isRecommended. Limited to 30 requests per day. This is a planning step - it does not create or generate an article and does not use credits. Feed a chosen title into Generate Outline or Generate Article.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Body

application/json
topics

Topic cluster name(s) to base titles on - normally the cluster the user already selected.

type
enum<string>

Article type. Defaults to listicle. Must match the outline's structure.

Available options:
listicle,
comparison,
news,
review,
guide
count
string

How many titles to return (1–20, default 8).

contentArticleType
enum<string>

Omit for a standalone post.

Available options:
pillar,
cluster
country
string
language
string

Response

200 - application/json

Default Response

output
object
required