Command reference

Every command also has an MCP tool with underscores in its name. Use --json for scripts.

account-statusCopy Anchor Link

Signed-in account and report limits.

semrush-cli account-status --help

keyword-overviewCopy Anchor Link

Volume, difficulty, CPC, intent and trends.

semrush-cli keyword-overview --help

keyword-ideasCopy Anchor Link

Overview sample of related keywords or questions.

semrush-cli keyword-ideas --help

keyword-ideas-summaryCopy Anchor Link

Total related keyword count and volume.

semrush-cli keyword-ideas-summary --help

keyword-serpCopy Anchor Link

Ranked URLs and SERP features.

semrush-cli keyword-serp --help

keyword-adsCopy Anchor Link

Search ad copies for a keyword.

semrush-cli keyword-ads --help

keyword-clustersCopy Anchor Link

Keyword topics and search intents.

semrush-cli keyword-clusters --help

keyword-magicCopy Anchor Link

Paginated Keyword Magic research with filters and sorting.

semrush-cli keyword-magic --help

keyword-magic-summaryCopy Anchor Link

Keyword Magic totals for matching filters.

semrush-cli keyword-magic-summary --help

keyword-magic-groupsCopy Anchor Link

Keyword Magic topic groups.

semrush-cli keyword-magic-groups --help

domain-overviewCopy Anchor Link

Search metrics and backlink summary.

semrush-cli domain-overview --help

domain-keywordsCopy Anchor Link

Paginated organic rankings with filters, sorting and totals.

semrush-cli domain-keywords --help

domain-pagesCopy Anchor Link

Paginated top organic pages with totals.

semrush-cli domain-pages --help

domain-subdomainsCopy Anchor Link

Paginated organic subdomain traffic and keyword totals.

semrush-cli domain-subdomains --help

domain-position-changesCopy Anchor Link

Paginated ranking changes with totals.

semrush-cli domain-position-changes --help

domain-competitorsCopy Anchor Link

Paginated organic search competitors and totals.

semrush-cli domain-competitors --help

domain-backlinksCopy Anchor Link

Backlink summary, sample links and anchors.

semrush-cli domain-backlinks --help

domain-ai-visibilityCopy Anchor Link

AI visibility, mentions and citations.

semrush-cli domain-ai-visibility --help

domain-ai-countriesCopy Anchor Link

AI visibility and mentions by country.

semrush-cli domain-ai-countries --help

domain-ai-sourcesCopy Anchor Link

Top AI citation sources with offset and limit.

semrush-cli domain-ai-sources --help

domain-trendsCopy Anchor Link

Daily or monthly organic and paid search trends.

semrush-cli domain-trends --help

domain-paid-keywordsCopy Anchor Link

Paid keyword overview sample; account permissions apply.

semrush-cli domain-paid-keywords --help

domain-paid-competitorsCopy Anchor Link

Paid search competitors; account permissions apply.

semrush-cli domain-paid-competitors --help

domain-topicsCopy Anchor Link

Organic search topics already available for a domain.

semrush-cli domain-topics --help

domain-topics-statusCopy Anchor Link

Availability of domain organic topics.

semrush-cli domain-topics-status --help

databasesCopy Anchor Link

Search databases and account access.

semrush-cli databases --help

snapshot-datesCopy Anchor Link

Available historical domain snapshots.

semrush-cli snapshot-dates --help

report-permissionsCopy Anchor Link

Account history, export and research permissions.

semrush-cli report-permissions --help

backlink-linksCopy Anchor Link

Paginated backlinks with provider caps and totals.

semrush-cli backlink-links --help

backlink-referring-domainsCopy Anchor Link

Paginated referring domains.

semrush-cli backlink-referring-domains --help

backlink-historyCopy Anchor Link

Historical backlink and referring-domain trends.

semrush-cli backlink-history --help

backlink-competitorsCopy Anchor Link

Competitors sharing a backlink profile.

semrush-cli backlink-competitors --help

backlink-top-pagesCopy Anchor Link

Paginated indexed pages ranked by referring domains.

semrush-cli backlink-top-pages --help

backlink-anchorsCopy Anchor Link

Paginated anchor texts and backlink counts.

semrush-cli backlink-anchors --help

backlink-outgoing-domainsCopy Anchor Link

Paginated outbound domains and outgoing link counts.

semrush-cli backlink-outgoing-domains --help

backlink-countriesCopy Anchor Link

Referring-domain country distribution.

semrush-cli backlink-countries --help

backlink-authorityCopy Anchor Link

Authority score and supporting metrics.

semrush-cli backlink-authority --help

backlink-categoriesCopy Anchor Link

Referring-domain category profile.

semrush-cli backlink-categories --help

keyword-gapCopy Anchor Link

Paginated organic keyword gap between two to five sites.

semrush-cli keyword-gap --help

keyword-gap-totalsCopy Anchor Link

Counts for keyword overlap and opportunity types.

semrush-cli keyword-gap-totals --help

keyword-gap-overlapCopy Anchor Link

Organic keyword profile overlaps.

semrush-cli keyword-gap-overlap --help

backlink-gapCopy Anchor Link

Paginated link-building prospects shared by competitors but missing from your site.

semrush-cli backlink-gap --help

backlink-comparisonCopy Anchor Link

Compare backlink history, country distribution and domain zones.

semrush-cli backlink-comparison --help

projectsCopy Anchor Link

Existing projects and folder access, with pagination.

semrush-cli projects --help

ai-capabilitiesCopy Anchor Link

Account AI Visibility Toolkit access and limits.

semrush-cli ai-capabilities --help

audit-campaignsCopy Anchor Link

Existing Site Audit campaigns; does not start a crawl.

semrush-cli audit-campaigns --help

foldersCopy Anchor Link

Accessible project folders.

semrush-cli folders --help

saved-keyword-listsCopy Anchor Link

Existing saved keyword lists.

semrush-cli saved-keyword-lists --help

project-createCopy Anchor Link

Create a project, optionally with a website. Does not start tools or share it.

semrush-cli project-create --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

project-getCopy Anchor Link

Read one project by its current web folder ID.

semrush-cli project-get --help

project-updateCopy Anchor Link

Rename a project or add its first domain. Existing domains cannot be changed.

semrush-cli project-update --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

project-deleteCopy Anchor Link

Permanently delete a project and its attached tool data.

semrush-cli project-delete --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

project-leaveCopy Anchor Link

Leave a shared project.

semrush-cli project-leave --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

project-limitsCopy Anchor Link

Read project creation limits.

semrush-cli project-limits --help

project-tagsCopy Anchor Link

Read available project tags.

semrush-cli project-tags --help

project-set-tagsCopy Anchor Link

Replace project tags. An empty array removes all its tags.

semrush-cli project-set-tags --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

project-check-domainCopy Anchor Link

Check website information before creating a project.

semrush-cli project-check-domain --help

project-pinCopy Anchor Link

Pin or unpin a project on the dashboard.

semrush-cli project-pin --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

project-toolkitsCopy Anchor Link

Read SEO, AI, local, social, advertising and content toolkit status.

semrush-cli project-toolkits --help

project-toolsCopy Anchor Link

Read project dashboard metrics. Tool IDs match the web dashboard.

semrush-cli project-tools --help

project-enable-seoCopy Anchor Link

Create the SEO project associated with an existing web project. Uses project allowance.

semrush-cli project-enable-seo --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

project-seo-auto-setupCopy Anchor Link

Start automatic SEO setup, including Site Audit and Position Tracking. Uses account allowances.

semrush-cli project-seo-auto-setup --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

keyword-list-limitsCopy Anchor Link

Read Keyword Strategy Builder list and clustering allowances.

semrush-cli keyword-list-limits --help

keyword-listsCopy Anchor Link

Read regular and structured keyword lists with pagination and ownership filters.

semrush-cli keyword-lists --help

keyword-list-createCopy Anchor Link

Create an empty regular keyword list. Does not cluster or generate a strategy.

semrush-cli keyword-list-create --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

keyword-list-getCopy Anchor Link

Read one keyword list and its permissions.

semrush-cli keyword-list-get --help

keyword-list-renameCopy Anchor Link

Rename a keyword list.

semrush-cli keyword-list-rename --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

keyword-list-deleteCopy Anchor Link

Permanently delete one of your keyword lists.

semrush-cli keyword-list-delete --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

keyword-list-keywordsCopy Anchor Link

Read filtered, paginated keyword-list metrics.

semrush-cli keyword-list-keywords --help

keyword-list-summaryCopy Anchor Link

Read keyword totals, volume and difficulty for the selected filters.

semrush-cli keyword-list-summary --help

keyword-list-importCopy Anchor Link

Import phrases into a regular keyword list. Account keyword limits apply.

semrush-cli keyword-list-import --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

keyword-list-delete-keywordsCopy Anchor Link

Delete selected phrases from a keyword list. Returns an undo ID.

semrush-cli keyword-list-delete-keywords --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

keyword-list-undo-deleteCopy Anchor Link

Restore a keyword deletion using its returned UndoID.

semrush-cli keyword-list-undo-delete --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

keyword-list-update-metricsCopy Anchor Link

Request fresh metrics for selected phrases. Consumes the update allowance.

semrush-cli keyword-list-update-metrics --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

keyword-list-tagsCopy Anchor Link

Read keyword tags and their usage in a list.

semrush-cli keyword-list-tags --help

keyword-list-add-tagsCopy Anchor Link

Add tags to selected phrases.

semrush-cli keyword-list-add-tags --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

keyword-list-remove-tagsCopy Anchor Link

Remove tags from selected phrases.

semrush-cli keyword-list-remove-tags --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

keyword-list-clusterCopy Anchor Link

Start clustering a keyword list. Consumes the clustering allowance.

semrush-cli keyword-list-cluster --help

Requires --confirm. Use --dry-run to inspect the request without sending it.

keyword-list-cluster-forecastCopy Anchor Link

Read the clustering forecast for a keyword list.

semrush-cli keyword-list-cluster-forecast --help

keyword-list-cluster-statusCopy Anchor Link

Read the current clustering status for a keyword list.

semrush-cli keyword-list-cluster-status --help

keyword-strategy-createCopy Anchor Link

Generate a structured keyword strategy from a domain or seed phrases. Consumes the clustering allowance.

semrush-cli keyword-strategy-create --help

Requires --confirm. Use --dry-run to inspect the request without sending it.