Hanzo
OpenapiSeo

Grow a seed phrase into the phrases nobody named yet

Grows a seed phrase into the phrases nobody named yet.

POST /v1/seo/ideas

Addresshttps://api.hanzo.ai/v1/seo/ideas
MethodPOST
OperationseoIdea
AuthAuthorization: Bearer $HANZO_API_KEY

Grows a seed phrase into the phrases nobody named yet.

It takes phrases you have and returns phrases in the same category that you do not — relevant rather than merely containing the seed — each with its search volume, click cost, competition and how hard its first page is to reach. This is where a keyword list comes FROM; seoKeyword is where a list you already have gets measured.

It is priced per row, so Limit is the knob that decides what the call costs. Total says how many more there were.

Request

4 fields, body application/json (required).

FieldInTypeRequiredDescription
keywordsbodystring[]Keywords are the seeds.
languagebodystringLanguage is the ISO code.
limitbodyintegerLimit is how many phrases to return, 1 to 1000.
locationbodyintegerLocation is the market, as the upstream's numeric code.

Response

StatusBodyMeaning
200seoIdeaOutok

200 body — 9 fields.

FieldInTypeAlwaysDescription
costbodystringCost is what this call cost, in USD, as an exact decimal string.
keywordsbodyseoMetric[]Keywords is the phrases found, each measured.
keywords[].competitionbodynumberCompetition is how contested the advertising is, from 0 to 1.
keywords[].cpcbodynumberCPC is the average cost of one advertising click, in USD.
keywords[].difficultybodyintegerDifficulty is how hard the first page is to reach organically, 0 to 100.
keywords[].keywordbodystringKeyword is the phrase.
keywords[].levelbodystringLevel is the same fact as a word: low, medium or high.
keywords[].volumebodyintegerVolume is the average monthly searches.
totalbodyintegerTotal is how many the upstream holds, which is usually more than Limit returned — it is what raising the limit would reach.

Failure carries the platform error shape — see Errors.

Examples

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.


SEO API · All Hanzo APIs · Interactive reference

How is this guide?

On this page