harborrank

Save keywords

save_keywords

Destructive

Save keywords to a project's saved-keywords list. Idempotent: re-saving an existing keyword is a no-op. If tags are provided, missing tags may be created. By default tags are appended; set tagMode=replace to remove existing tags from these saved keywords before applying the provided tags, which is useful for reorganizing keywords into page/topic clusters. Ask the user for confirmation before applying or replacing tags broadly.

Input Schema

TableJSON Schema

Name	Required	Description
`tags`	No	Optional tags to attach to every saved keyword. Ask the user for explicit confirmation before using this, especially when saving many keywords or creating new tag names.
`tagMode`	No	How to apply tags. Defaults to append. Use replace to remove existing tags from these saved keywords before applying the provided tags.
`keywords`	Yes	Keywords to save (1-100).
`projectId`	Yes	Required. The HarborRank project ID to scope this call to. Get one from list_projects.
`languageCode`	No	Language code (e.g. 'en', 'es', 'vi'). Defaults to the project's default market language (see list_projects).
`locationCode`	No	DataForSEO location code. Defaults to the project's default market (see list_projects; editable in project settings). See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable.