Skip to main content
POST
Generate target keywords for an article
Generate target keywords (with search volume and relevance) for an article title. Optionally pass competitor URLs - from Find Competitor Sources - to mine keywords from their pages. JSON body fields: title (required), user_keywords, competitor_links, keyword_count (1-40, default 10), topicId (offers the cluster’s keywords no article covers yet), country, and language. The response streams newline-delimited JSON (application/x-ndjson): progress lines contain status, and the final line is { keywords, cannibalization }. An error after streaming starts arrives as an error line with HTTP 200. Limited to 20 requests per day. Use the chosen keywords when calling Generate Outline or Generate Article.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Body

application/json
title
string
required

Article title to generate keywords for.

user_keywords

Existing keywords to prioritize and expand.

Competitor article URLs to crawl for keyword mining.

keyword_count
string

How many keywords to return (1–40, default 10).

topicId
string

Topic cluster id. Its keywords that no article covers yet are offered to the model.

country
string
language
string

Response

200 - application/x-ndjson

A newline-delimited stream. Whitespace keeps the connection alive; status and final result are JSON lines. An error after streaming starts is returned as a JSON error line with HTTP 200.

Newline-delimited JSON events