Content Plan Keyword Research Object


A keyword research item is one target keyword in a site's content plan, together with the search data behind it and the page it belongs to.

The content plan pipeline generates a set of these for a site. A site owner can then refine them, and the blog post briefs are built from the result.

Items are grouped into clusters. Each site page has one main keyword, marked by primary, and the other keywords in that cluster support it.

Properties
clusterNamestringmaxLength 1000

Name of the cluster that groups this keyword with the others covering the same topic.


competitionintegerformat int32

How hard it is to rank for the keyword, on a scale where a higher number means more competition.

Recalculated when keyword changes, even if you don't name this field in the field mask.


idstringRead-onlyformat GUID

Keyword research item ID.


itemTypestringmaxLength 1000

Type of the site page the keyword is assigned to, such as a static page or a blog post.


keywordstringmaxLength 1000

The keyword itself.

An update is rejected if the new keyword is longer than 80 characters, or if it duplicates another keyword in the same research.


pageDeletedboolean

Whether the site page this keyword is assigned to has been deleted.

A keyword assigned to a deleted page stays in the research.


pageIdstringmaxLength 1000

ID of the site page the keyword is assigned to.


pageUrlstringmaxLength 1000

URL of the site page the keyword is assigned to.


primaryboolean

Whether this keyword is the main keyword for its page.

A page has a single main keyword, and the other keywords in its cluster support it.


searchVolumeintegerformat int32

Estimated number of searches for the keyword per month.

Recalculated when keyword changes, even if you don't name this field in the field mask.

Did this help?