> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: Content Plan Keyword Research V1

# Type: Content Plan Keyword Research Object

# Link: https://dev.wix.com/docs/api-reference/business-management/seo/content-plan-keyword-research-v1/content-plan-keyword-research-object.md

## Description: 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.

## Schema:

```json
 Type: Content Plan Keyword Research Object | type: KeywordResearch
 Description: 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.
       - name: id  | type: string | description: Keyword research item ID.
           - name: value  | type: string | description: 
       - name: keyword  | type: string | description: 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.
       - name: pageId  | type: string | description: ID of the site page the keyword is assigned to.
       - name: itemType  | type: string | description: Type of the site page the keyword is assigned to, such as a static page or a blog post.
       - name: pageUrl  | type: string | description: URL of the site page the keyword is assigned to.
       - name: competition  | type: number | description: 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.
           - name: value  | type: number | description: 
       - name: searchVolume  | type: number | description: 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.
       - name: pageDeleted  | type: boolean | description: Whether the site page this keyword is assigned to has been deleted.  A keyword assigned to a deleted page stays in the research.
           - name: value  | type: boolean | description: 
       - name: primary  | type: boolean | description: 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.
       - name: clusterName  | type: string | description: Name of the cluster that groups this keyword with the others covering the same topic.

```