semrush-cli

saved-keyword-lists

List Saved Keywords collections with filters, pagination and ownership selection.

semrush saved-keyword-lists --help

MCP tool: saved_keyword_lists.

Option	Type	Default	Description
`--filter`	string	`""`	Native Saved Keywords FilterQL, for example volume >= 100 AND phrase CONTAINS "seo".
`--limit`	integer	`1000`
`--offset`	integer	`0`
`--sort-field`	string	`"updated"`	Values: `"name"`, `"keywords"`, `"updated"`.
`--descending`	boolean	`true`
`--ownership`	string	`"all"`	Values: `"all"`, `"own"`, `"shared"`, `"team"`.

saved-keyword-list-get

Read one exact Saved Keywords collection.

semrush saved-keyword-list-get --help

MCP tool: saved_keyword_list_get.

Option	Type	Default	Description
`--list-id`	string		Required.

saved-keyword-lists-summary

Read collection counts by ownership.

semrush saved-keyword-lists-summary --help

MCP tool: saved_keyword_lists_summary.

Option	Type	Default	Description
`--filter`	string	`""`	Native Saved Keywords FilterQL, for example volume >= 100 AND phrase CONTAINS "seo".

saved-keyword-info

Read Saved Keywords account access.

semrush saved-keyword-info --help

MCP tool: saved_keyword_info.

saved-keyword-limits

Read Saved Keywords keyword and update allowances.

semrush saved-keyword-limits --help

MCP tool: saved_keyword_limits.

saved-keyword-list-create

Create an empty Saved Keywords collection.

semrush saved-keyword-list-create --help

MCP tool: saved_keyword_list_create.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--name`	string		Required.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

saved-keyword-list-rename

Rename a Saved Keywords collection.

semrush saved-keyword-list-rename --help

MCP tool: saved_keyword_list_rename.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--list-id`	string		Required.
`--name`	string		Required.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

saved-keyword-list-delete

Delete selected Saved Keywords collections; returns an undo ID.

semrush saved-keyword-list-delete --help

MCP tool: saved_keyword_list_delete.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--list-ids`	array		Required.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

saved-keyword-list-undo-delete

Restore a deleted Saved Keywords collection using its undo ID.

semrush saved-keyword-list-undo-delete --help

MCP tool: saved_keyword_list_undo_delete.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--undo-id`	string		Required.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

Read the collection’s tags.

semrush saved-keyword-list-tags --help

MCP tool: saved_keyword_list_tags.

Option	Type	Default	Description
`--list-id`	string		Required.

saved-keyword-list-labels

Read the collection’s labels.

semrush saved-keyword-list-labels --help

MCP tool: saved_keyword_list_labels.

Option	Type	Default	Description
`--list-id`	string		Required.

saved-keyword-list-topics

Read the collection’s topics.

semrush saved-keyword-list-topics --help

MCP tool: saved_keyword_list_topics.

Option	Type	Default	Description
`--list-id`	string		Required.

saved-keyword-list-subtopics

Read the collection’s subtopics.

semrush saved-keyword-list-subtopics --help

MCP tool: saved_keyword_list_subtopics.

Option	Type	Default	Description
`--list-id`	string		Required.

saved-keyword-list-databases

Read the collection’s databases.

semrush saved-keyword-list-databases --help

MCP tool: saved_keyword_list_databases.

Option	Type	Default	Description
`--list-id`	string		Required.

saved-keywords

Read saved keywords with native filters, pagination and sorting.

semrush saved-keywords --help

MCP tool: saved_keywords.

Option	Type	Default	Description
`--list-id`	string		Required.
`--filter`	string	`""`	Native Saved Keywords FilterQL, for example volume >= 100 AND phrase CONTAINS "seo".
`--sort-field`	string	`"phrase"`	Values: `"phrase"`, `"volume"`, `"difficulty"`, `"topic"`, `"subtopic"`, `"updated"`, `"cpc"`.
`--descending`	boolean	`false`
`--limit`	integer	`20`
`--offset`	integer	`0`

saved-keywords-summary

Read saved keyword summary.

semrush saved-keywords-summary --help

MCP tool: saved_keywords_summary.

Option	Type	Default	Description
`--list-id`	string		Required.
`--filter`	string	`""`	Native Saved Keywords FilterQL, for example volume >= 100 AND phrase CONTAINS "seo".

saved-keywords-phrases

Read saved keyword phrases.

semrush saved-keywords-phrases --help

MCP tool: saved_keywords_phrases.

Option	Type	Default	Description
`--list-id`	string		Required.
`--filter`	string	`""`	Native Saved Keywords FilterQL, for example volume >= 100 AND phrase CONTAINS "seo".

saved-keywords-top-competitors

Read saved keyword top competitors.

semrush saved-keywords-top-competitors --help

MCP tool: saved_keywords_top_competitors.

Option	Type	Default	Description
`--list-id`	string		Required.
`--filter`	string	`""`	Native Saved Keywords FilterQL, for example volume >= 100 AND phrase CONTAINS "seo".

saved-keyword-competitors

Read competing URLs for one saved keyword.

semrush saved-keyword-competitors --help

MCP tool: saved_keyword_competitors.

Option	Type	Default	Description
`--keyword-id`	string		Required.

saved-keywords-import

Import phrases and tags into a Saved Keywords collection.

semrush saved-keywords-import --help

MCP tool: saved_keywords_import.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--list-id`	string		Required.
`--keywords`	array		Required.
`--database`	string	`"us"`	Values: `"ae"`, `"af"`, `"al"`, `"am"`, `"ao"`, `"ar"`, `"at"`, `"au"`, `"az"`, `"ba"`, `"bd"`, `"be"`, `"bg"`, `"bh"`, `"bn"`, `"bo"`, `"br"`, `"bs"`, `"bw"`, `"by"`, `"bz"`, `"ca"`, `"cd"`, `"ch"`, `"cl"`, `"cm"`, `"co"`, `"cr"`, `"cv"`, `"cy"`, `"cz"`, `"de"`, `"dk"`, `"do"`, `"dz"`, `"ec"`, `"ee"`, `"eg"`, `"es"`, `"et"`, `"fi"`, `"fr"`, `"ge"`, `"gh"`, `"gr"`, `"gt"`, `"gy"`, `"hk"`, `"hn"`, `"hr"`, `"ht"`, `"hu"`, `"id"`, `"ie"`, `"il"`, `"in"`, `"is"`, `"it"`, `"jm"`, `"jo"`, `"jp"`, `"kh"`, `"kr"`, `"kw"`, `"kz"`, `"lb"`, `"lk"`, `"lt"`, `"lu"`, `"lv"`, `"ly"`, `"ma"`, `"md"`, `"me"`, `"mg"`, `"mn"`, `"mt"`, `"mu"`, `"mx"`, `"my"`, `"mz"`, `"na"`, `"ng"`, `"ni"`, `"nl"`, `"no"`, `"np"`, `"nz"`, `"om"`, `"pa"`, `"pe"`, `"ph"`, `"pk"`, `"pl"`, `"pt"`, `"py"`, `"qa"`, `"ro"`, `"rs"`, `"ru"`, `"sa"`, `"se"`, `"sg"`, `"si"`, `"sk"`, `"sn"`, `"sv"`, `"th"`, `"tn"`, `"tr"`, `"tt"`, `"tw"`, `"ua"`, `"uk"`, `"us"`, `"uy"`, `"ve"`, `"vn"`, `"za"`, `"zm"`, `"zw"`.
`--tags`	array	`[]`
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

saved-keywords-delete

Delete selected saved keywords; returns an undo ID.

semrush saved-keywords-delete --help

MCP tool: saved_keywords_delete.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--list-id`	string		Required.
`--keyword-ids`	array
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.
`--filter`	string		Explicit native FilterQL selection. Provide this or keyword_ids, not both.

saved-keywords-update-metrics

Request metric refresh for selected saved keywords; consumes update allowance.

semrush saved-keywords-update-metrics --help

MCP tool: saved_keywords_update_metrics.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--list-id`	string		Required.
`--keyword-ids`	array
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.
`--filter`	string		Explicit native FilterQL selection. Provide this or keyword_ids, not both.

saved-keywords-undo-delete

Restore deleted saved keywords with their undo ID.

semrush saved-keywords-undo-delete --help

MCP tool: saved_keywords_undo_delete.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--undo-id`	string		Required.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

saved-keywords-add-tags

Add tags on selected saved keywords.

semrush saved-keywords-add-tags --help

MCP tool: saved_keywords_add_tags.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--list-id`	string		Required.
`--keyword-ids`	array
`--tags`	array		Required.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.
`--filter`	string		Explicit native FilterQL selection. Provide this or keyword_ids, not both.

saved-keywords-remove-tags

Remove tags on selected saved keywords.

semrush saved-keywords-remove-tags --help

MCP tool: saved_keywords_remove_tags.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--list-id`	string		Required.
`--keyword-ids`	array
`--tags`	array		Required.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.
`--filter`	string		Explicit native FilterQL selection. Provide this or keyword_ids, not both.

saved-keywords-copy

Copy selected keywords to a different Saved Keywords collection.

semrush saved-keywords-copy --help

MCP tool: saved_keywords_copy.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--list-id`	string		Required.
`--target-list-id`	string		Required.
`--keyword-ids`	array
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.
`--filter`	string		Explicit native FilterQL selection. Provide this or keyword_ids, not both.

saved-keywords-move

Move selected keywords to a different Saved Keywords collection.

semrush saved-keywords-move --help

MCP tool: saved_keywords_move.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--list-id`	string		Required.
`--target-list-id`	string		Required.
`--keyword-ids`	array
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.
`--filter`	string		Explicit native FilterQL selection. Provide this or keyword_ids, not both.

saved-keywords-label

Mark selected keywords as tracked, content written or brief generated. Does not start those jobs.

semrush saved-keywords-label --help

MCP tool: saved_keywords_label.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--list-id`	string		Required.
`--keyword-ids`	array
`--labels`	array		Required.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.
`--filter`	string		Explicit native FilterQL selection. Provide this or keyword_ids, not both.

saved-keywords-export

Download filtered saved keywords as CSV, semicolon CSV or XLSX.

semrush saved-keywords-export --help

MCP tool: saved_keywords_export.

Pass --output <path> to save the file. Existing files are not overwritten. MCP returns an artifact resource.

Option	Type	Default	Description
`--list-id`	string		Required.
`--filter`	string	`""`	Native Saved Keywords FilterQL, for example volume >= 100 AND phrase CONTAINS "seo".
`--sort-field`	string	`"phrase"`	Values: `"phrase"`, `"volume"`, `"difficulty"`, `"topic"`, `"subtopic"`, `"updated"`, `"cpc"`.
`--descending`	boolean	`false`
`--format`	string	`"csv"`	Values: `"csv"`, `"csv_semicolon"`, `"xlsx"`.

Saved Keywords

saved-keyword-listsCopy Anchor Link

saved-keyword-list-getCopy Anchor Link

saved-keyword-lists-summaryCopy Anchor Link

saved-keyword-infoCopy Anchor Link

saved-keyword-limitsCopy Anchor Link

saved-keyword-list-createCopy Anchor Link

saved-keyword-list-renameCopy Anchor Link

saved-keyword-list-deleteCopy Anchor Link

saved-keyword-list-undo-deleteCopy Anchor Link

saved-keyword-list-tagsCopy Anchor Link

saved-keyword-list-labelsCopy Anchor Link

saved-keyword-list-topicsCopy Anchor Link

saved-keyword-list-subtopicsCopy Anchor Link

saved-keyword-list-databasesCopy Anchor Link

saved-keywordsCopy Anchor Link

saved-keywords-summaryCopy Anchor Link

saved-keywords-phrasesCopy Anchor Link

saved-keywords-top-competitorsCopy Anchor Link

saved-keyword-competitorsCopy Anchor Link

saved-keywords-importCopy Anchor Link

saved-keywords-deleteCopy Anchor Link

saved-keywords-update-metricsCopy Anchor Link

saved-keywords-undo-deleteCopy Anchor Link

saved-keywords-add-tagsCopy Anchor Link

saved-keywords-remove-tagsCopy Anchor Link

saved-keywords-copyCopy Anchor Link

saved-keywords-moveCopy Anchor Link

saved-keywords-labelCopy Anchor Link

saved-keywords-exportCopy Anchor Link

On this page

saved-keyword-lists

saved-keyword-list-get

saved-keyword-lists-summary

saved-keyword-info

saved-keyword-limits

saved-keyword-list-create

saved-keyword-list-rename

saved-keyword-list-delete

saved-keyword-list-undo-delete

saved-keyword-list-tags

saved-keyword-list-labels

saved-keyword-list-topics

saved-keyword-list-subtopics

saved-keyword-list-databases

saved-keywords

saved-keywords-summary

saved-keywords-phrases

saved-keywords-top-competitors

saved-keyword-competitors

saved-keywords-import

saved-keywords-delete

saved-keywords-update-metrics

saved-keywords-undo-delete

saved-keywords-add-tags

saved-keywords-remove-tags

saved-keywords-copy

saved-keywords-move

saved-keywords-label

saved-keywords-export