semrush-cli

backlink-audit-limits

Read Backlink Audit project allowance.

semrush backlink-audit-limits --help

MCP tool: backlink_audit_limits.

backlink-audit-campaigns

List SEO projects and their Backlink Audit campaign IDs.

semrush backlink-audit-campaigns --help

MCP tool: backlink_audit_campaigns.

backlink-audit-categories

Read native Backlink Audit category choices.

semrush backlink-audit-categories --help

MCP tool: backlink_audit_categories.

backlink-audit-countries

Read native Backlink Audit country choices.

semrush backlink-audit-countries --help

MCP tool: backlink_audit_countries.

backlink-audit-project

Read setup metadata and recommended settings for an SEO project.

semrush backlink-audit-project --help

MCP tool: backlink_audit_project.

Option	Type	Default	Description
`--project-id`	integer		Required. SEO project ID from project-enable-seo, not the folder ID.

backlink-audit-scopes

Read valid and permitted Backlink Audit scopes before creating a campaign.

semrush backlink-audit-scopes --help

MCP tool: backlink_audit_scopes.

Option	Type	Default	Description
`--project-id`	integer		Required. SEO project ID from project-enable-seo, not the folder ID.

backlink-audit-info

Read Backlink Audit metadata and its userDomainId for an SEO project.

semrush backlink-audit-info --help

MCP tool: backlink_audit_info.

Option	Type	Default	Description
`--project-id`	integer		Required. SEO project ID from project-enable-seo, not the folder ID.

backlink-audit-status

Read analysis progress, import status and current campaign metadata.

semrush backlink-audit-status --help

MCP tool: backlink_audit_status.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--background`	boolean	`false`

backlink-audit-links-summary

Read link counts and toxicity totals.

semrush backlink-audit-links-summary --help

MCP tool: backlink_audit_links_summary.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`

backlink-audit-domains-summary

Read referring-domain counts and toxicity totals.

semrush backlink-audit-domains-summary --help

MCP tool: backlink_audit_domains_summary.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`

backlink-audit-anchor-types

Read anchor-type distribution.

semrush backlink-audit-anchor-types --help

MCP tool: backlink_audit_anchor_types.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`

backlink-audit-rel-summary

Read link-attribute distribution.

semrush backlink-audit-rel-summary --help

MCP tool: backlink_audit_rel_summary.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`
`--by-domain`	boolean	`false`

backlink-audit-removed-summary

Read removal and disavow totals.

semrush backlink-audit-removed-summary --help

MCP tool: backlink_audit_removed_summary.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`

backlink-audit-historical-stats

Read historical domain statistics.

semrush backlink-audit-historical-stats --help

MCP tool: backlink_audit_historical_stats.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`

backlink-audit-authority-history

Read referring-domain authority history.

semrush backlink-audit-authority-history --help

MCP tool: backlink_audit_authority_history.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`

backlink-audit-domains-history

Read referring-domain count history.

semrush backlink-audit-domains-history --help

MCP tool: backlink_audit_domains_history.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`

backlink-audit-links-history

Read backlink count history.

semrush backlink-audit-links-history --help

MCP tool: backlink_audit_links_history.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`

backlink-audit-changes

Read new, broken or lost backlink trends.

semrush backlink-audit-changes --help

MCP tool: backlink_audit_changes.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`
`--list`	string	`"new"`	Values: `"new"`, `"broken"`, `"lost"`.
`--show-diff`	boolean	`true`
`--with-domains`	boolean	`true`

backlink-audit-authority-distribution

Read referring-domain authority distribution.

semrush backlink-audit-authority-distribution --help

MCP tool: backlink_audit_authority_distribution.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`

backlink-audit-link-types

Read backlink-type distribution.

semrush backlink-audit-link-types --help

MCP tool: backlink_audit_link_types.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`

backlink-audit-anchors

Read anchor distribution.

semrush backlink-audit-anchors --help

MCP tool: backlink_audit_anchors.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`
`--anchor-types`	array	`["all"]`
`--limit`	integer	`100`

backlink-audit-top-domains

Read top referring domains.

semrush backlink-audit-top-domains --help

MCP tool: backlink_audit_top_domains.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`
`--limit`	integer	`100`
`--only-toxic`	boolean	`false`

backlink-audit-recommendations

Read campaign recommendations without marking them read.

semrush backlink-audit-recommendations --help

MCP tool: backlink_audit_recommendations.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.

backlink-audit-create

Create and immediately start a Backlink Audit. Defaults to no recurring updates or notification email.

semrush backlink-audit-create --help

MCP tool: backlink_audit_create.

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

Option	Type	Default	Description
`--project-id`	integer		Required. SEO project ID from project-enable-seo, not the folder ID.
`--scope`	string	`"root"`	Values: `"root"`, `"both"`, `"www"`, `"nonwww"`.
`--brands`	array
`--categories`	array
`--countries`	array
`--recrawl`	string	`"never"`	Values: `"never"`, `"1week"`, `"2weeks"`, `"1month"`.
`--recrawl-notify`	boolean	`false`	Email notifications for recurring audit updates.
`--recrawl-majestic`	boolean	`false`	Refresh connected Majestic data during recurring updates.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

backlink-audit-configure

Change only supplied Backlink Audit settings, preserving omitted settings and integrations.

semrush backlink-audit-configure --help

MCP tool: backlink_audit_configure.

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--brands`	array
`--categories`	array
`--countries`	array
`--recrawl`	string		Values: `"never"`, `"1week"`, `"2weeks"`, `"1month"`.
`--recrawl-notify`	boolean		Email notifications for recurring audit updates.
`--recrawl-majestic`	boolean		Refresh connected Majestic data during recurring updates.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

backlink-audit-disavow-export

Export the disavow TXT file and mark its entries exported in Semrush. Does not upload to Google.

semrush backlink-audit-disavow-export --help

MCP tool: backlink_audit_disavow_export.

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

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--format`	string	`"txt"`	Values: `"txt"`.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

backlink-audit-links

Read the paginated audit table with native backlink filters and domain grouping.

semrush backlink-audit-links --help

MCP tool: backlink_audit_links.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`
`--authority-min`	integer / null	`null`
`--authority-max`	integer / null	`null`
`--anchor-types`	array	`[]`
`--category-id`	integer / null	`null`
`--is-new`	boolean / null	`null`
`--target-error`	boolean / null	`null`
`--link-type`	string / null	`null`
`--query`	string	`""`
`--query-mode`	string / null	`null`
`--rel`	string / null	`null`
`--toxic-markers`	array	`[]`
`--toxic-type`	string / null	`null`
`--mode`	string	`"for-review"`	Values: `"all"`, `"for-review"`, `"whitelist"`, `"to-remove"`, `"disavow"`, `"new"`, `"broken"`, `"lost"`.
`--by-domain`	boolean	`true`
`--source`	string / null	`null`
`--page`	integer	`0`
`--page-size`	integer	`50`
`--range-days`	integer
`--completely`	boolean	`false`

backlink-audit-links-count

Count backlinks matching the audit table filters.

semrush backlink-audit-links-count --help

MCP tool: backlink_audit_links_count.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`
`--authority-min`	integer / null	`null`
`--authority-max`	integer / null	`null`
`--anchor-types`	array	`[]`
`--category-id`	integer / null	`null`
`--is-new`	boolean / null	`null`
`--target-error`	boolean / null	`null`
`--link-type`	string / null	`null`
`--query`	string	`""`
`--query-mode`	string / null	`null`
`--rel`	string / null	`null`
`--toxic-markers`	array	`[]`
`--toxic-type`	string / null	`null`
`--mode`	string	`"for-review"`	Values: `"all"`, `"for-review"`, `"whitelist"`, `"to-remove"`, `"disavow"`, `"new"`, `"broken"`, `"lost"`.
`--by-domain`	boolean	`true`
`--source`	string / null	`null`
`--page`	integer	`0`
`--page-size`	integer	`50`
`--range-days`	integer
`--completely`	boolean	`false`

backlink-audit-link-categories

Read categories present in the audited backlink profile.

semrush backlink-audit-link-categories --help

MCP tool: backlink_audit_link_categories.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.

backlink-audit-disavow

Read paginated disavow domain and URL entries.

semrush backlink-audit-disavow --help

MCP tool: backlink_audit_disavow.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--query`	string / null	`null`
`--status`	integer / null	`null`
`--source`	string / null	`null`
`--type`	string / null	`null`
`--descending`	boolean	`true`
`--page`	integer	`0`
`--page-size`	integer	`50`

backlink-audit-disavow-count

Count disavow entries matching the selected filters.

semrush backlink-audit-disavow-count --help

MCP tool: backlink_audit_disavow_count.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--query`	string / null	`null`
`--status`	integer / null	`null`
`--source`	string / null	`null`
`--type`	string / null	`null`

backlink-audit-disavow-counters

Read disavow workflow counters with optional target-page selection.

semrush backlink-audit-disavow-counters --help

MCP tool: backlink_audit_disavow_counters.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`

backlink-audit-disavow-import

Import an existing disavow TXT file into Semrush. Can remove prior imported entries absent from the file; imported entries are marked disavowed. Does not upload to Google.

semrush backlink-audit-disavow-import --help

MCP tool: backlink_audit_disavow_import.

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

Option	Type	Default	Description
`--contents-file`	file or stdin		Required. Native disavow TXT contents. Import queues parsing; use backlink-audit-status to inspect completion.
`--filename`	string	`"semrush-disavow.txt"`	Disavow upload filename, ending in .txt.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.

backlink-audit-move-domains

Move selected referring domains to a Semrush review, whitelist, remove or disavow list. Does not contact websites or upload to Google.

semrush backlink-audit-move-domains --help

MCP tool: backlink_audit_move_domains.

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--ids`	array		Required. Native row id values from the corresponding grouped or individual audit table, not urlHash values.
`--list`	string		Required. Values: `"for-review"`, `"whitelist"`, `"to-remove"`, `"disavow"`.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

backlink-audit-move-links

Move selected individual backlinks to a Semrush review, whitelist, remove or disavow list. Does not contact websites or upload to Google.

semrush backlink-audit-move-links --help

MCP tool: backlink_audit_move_links.

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--ids`	array		Required. Native row id values from the corresponding grouped or individual audit table, not urlHash values.
`--list`	string		Required. Values: `"for-review"`, `"whitelist"`, `"to-remove"`, `"disavow"`.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

backlink-audit-move-networks

Move selected link networks to a Semrush review, whitelist, remove or disavow list. Does not contact websites or upload to Google.

semrush backlink-audit-move-networks --help

MCP tool: backlink_audit_move_networks.

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--ids`	array		Required. Native linkNetworkId values.
`--list`	string		Required. Values: `"for-review"`, `"whitelist"`, `"to-remove"`, `"disavow"`.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

backlink-audit-disavow-move

Move a disavow item and its associated backlinks back to a Semrush review, whitelist or remove list. Does not update Google.

semrush backlink-audit-disavow-move --help

MCP tool: backlink_audit_disavow_move.

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--list`	string		Required. Values: `"for-review"`, `"whitelist"`, `"to-remove"`.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.
`--item-id`	integer		Required. Native numeric id from backlink-audit-disavow, not a backlink row id.

backlink-audit-disavow-delete

Delete a selected item from the Semrush disavow list. Does not update Google.

semrush backlink-audit-disavow-delete --help

MCP tool: backlink_audit_disavow_delete.

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.
`--item-id`	integer		Required. Native numeric id from backlink-audit-disavow, not a backlink row id.

backlink-audit-disavow-clear

Clear explicitly selected manual, file-imported or Disavow Tool-imported items from the Semrush list. Manual links return to Audit and Lost & Found; does not update Google.

semrush backlink-audit-disavow-clear --help

MCP tool: backlink_audit_disavow_clear.

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.
`--with-manual`	boolean	`false`	Move manually added links back to Audit and Lost & Found.
`--with-file`	boolean	`false`	Remove items imported from a disavow file.
`--with-gdt`	boolean	`false`	Remove items imported from the Google Disavow Tool.

backlink-audit-target-pages

Read the native Target Pages table, including active/new/broken/lost counts and connected GA metrics.

semrush backlink-audit-target-pages --help

MCP tool: backlink_audit_target_pages.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--query`	string	`""`
`--query-mode`	string / null	`null`
`--by-domain`	boolean	`true`	Count backlinks grouped by referring domain; false counts individual backlinks.
`--target-error`	boolean / null	`null`
`--labels`	array	`[]`
`--is-new`	boolean	`false`
`--sort-field`	string	`"active"`	Values: `"active"`, `"new"`, `"broken"`, `"lost"`, `"ga_users"`, `"ga_users_perc"`, `"ga_new_users"`, `"ga_new_users_perc"`.
`--descending`	boolean	`true`
`--page`	integer	`0`
`--page-size`	integer	`50`

backlink-audit-target-pages-count

Count Target Pages matching the same native filters.

semrush backlink-audit-target-pages-count --help

MCP tool: backlink_audit_target_pages_count.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--query`	string	`""`
`--query-mode`	string / null	`null`
`--by-domain`	boolean	`true`	Count backlinks grouped by referring domain; false counts individual backlinks.
`--target-error`	boolean / null	`null`
`--labels`	array	`[]`
`--is-new`	boolean	`false`

backlink-audit-tags

Read campaign target-page labels.

semrush backlink-audit-tags --help

MCP tool: backlink_audit_tags.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.

backlink-audit-tag-counts

Read target-page counts for each campaign label.

semrush backlink-audit-tag-counts --help

MCP tool: backlink_audit_tag_counts.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.

backlink-audit-target-tag-add

Add a label to a target URL in this campaign.

semrush backlink-audit-target-tag-add --help

MCP tool: backlink_audit_target_tag_add.

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--label`	string		Required.
`--target-url`	string		Required. Native target URL from the Target Pages table.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

backlink-audit-target-tag-remove

Remove a label from a selected target URL, preserving other label associations.

semrush backlink-audit-target-tag-remove --help

MCP tool: backlink_audit_target_tag_remove.

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--label`	string		Required.
`--target-url`	string		Required. Native target URL from the Target Pages table.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

backlink-audit-tag-delete

Delete a label and all its associations in this campaign.

semrush backlink-audit-tag-delete --help

MCP tool: backlink_audit_tag_delete.

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--label`	string		Required.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

backlink-audit-comments

Read referring-domain comments by native numeric comment IDs.

semrush backlink-audit-comments --help

MCP tool: backlink_audit_comments.

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--ids`	array		Required.

backlink-audit-comment-save

Create or replace a referring-domain comment in this campaign.

semrush backlink-audit-comment-save --help

MCP tool: backlink_audit_comment_save.

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--domain`	string		Required. Native referring-domain source value, not its backlink row ID.
`--comment`	string		Required. Comment text; use comment-delete to clear a saved comment.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

backlink-audit-comment-delete

Delete a selected referring-domain comment.

semrush backlink-audit-comment-delete --help

MCP tool: backlink_audit_comment_delete.

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--comment-id`	integer		Required.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

backlink-audit-rerun

Rerun a ready audit when the native account allowance permits it; preserves recurring settings.

semrush backlink-audit-rerun --help

MCP tool: backlink_audit_rerun.

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

backlink-audit-export

Export the filtered current backlink table as native CSV. Starts one job and waits for its file; uses your existing account access.

semrush backlink-audit-export --help

MCP tool: backlink_audit_export.

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

Option	Type	Default	Description
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.
`--target-url-hash`	string / null	`null`
`--target-url-path`	string / null	`null`
`--authority-min`	integer / null	`null`
`--authority-max`	integer / null	`null`
`--anchor-types`	array	`[]`
`--category-id`	integer / null	`null`
`--is-new`	boolean / null	`null`
`--target-error`	boolean / null	`null`
`--link-type`	string / null	`null`
`--query`	string	`""`
`--query-mode`	string / null	`null`
`--rel`	string / null	`null`
`--toxic-markers`	array	`[]`
`--toxic-type`	string / null	`null`
`--mode`	string	`"for-review"`	Values: `"all"`, `"for-review"`, `"whitelist"`, `"to-remove"`, `"disavow"`, `"new"`, `"broken"`, `"lost"`.
`--by-domain`	boolean	`true`
`--source`	string / null	`null`
`--range-days`	integer
`--completely`	boolean	`false`
`--format`	string	`"csv"`	Values: `"csv"`.

backlink-audit-import

Import a CSV of source URLs and start native backlink crawling. Requires a ready, unlocked audit; an import cannot be stopped after commit.

semrush backlink-audit-import --help

MCP tool: backlink_audit_import.

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

Option	Type	Default	Description
`--contents-file`	file or stdin		Required. Native CSV containing source URLs in its first column. Sent unchanged; files with no importable URLs are refused before commit.
`--filename`	string	`"semrush-backlinks.csv"`	CSV upload filename ending in .csv.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.
`--audit-id`	integer		Required. Backlink Audit userDomainId returned by backlink-audit-info.

backlink-audit-replace-scope

Replace a ready audit with a fresh scope and retain its settings. Permanently discards the old audit's analysis and starts new analysis.

semrush backlink-audit-replace-scope --help

MCP tool: backlink_audit_replace_scope.

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

Option	Type	Default	Description
`--project-id`	integer		Required. SEO project ID from project-enable-seo, not the folder ID.
`--scope`	string		Required. Values: `"root"`, `"both"`, `"www"`, `"nonwww"`.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request plan; current settings are loaded only during execution.

Backlink Audit

backlink-audit-limitsCopy Anchor Link

backlink-audit-campaignsCopy Anchor Link

backlink-audit-categoriesCopy Anchor Link

backlink-audit-countriesCopy Anchor Link

backlink-audit-projectCopy Anchor Link

backlink-audit-scopesCopy Anchor Link

backlink-audit-infoCopy Anchor Link

backlink-audit-statusCopy Anchor Link

backlink-audit-links-summaryCopy Anchor Link

backlink-audit-domains-summaryCopy Anchor Link

backlink-audit-anchor-typesCopy Anchor Link

backlink-audit-rel-summaryCopy Anchor Link

backlink-audit-removed-summaryCopy Anchor Link

backlink-audit-historical-statsCopy Anchor Link

backlink-audit-authority-historyCopy Anchor Link

backlink-audit-domains-historyCopy Anchor Link

backlink-audit-links-historyCopy Anchor Link

backlink-audit-changesCopy Anchor Link

backlink-audit-authority-distributionCopy Anchor Link

backlink-audit-link-typesCopy Anchor Link

backlink-audit-anchorsCopy Anchor Link

backlink-audit-top-domainsCopy Anchor Link

backlink-audit-recommendationsCopy Anchor Link

backlink-audit-createCopy Anchor Link

backlink-audit-configureCopy Anchor Link

backlink-audit-disavow-exportCopy Anchor Link

backlink-audit-linksCopy Anchor Link

backlink-audit-links-countCopy Anchor Link

backlink-audit-link-categoriesCopy Anchor Link

backlink-audit-disavowCopy Anchor Link

backlink-audit-disavow-countCopy Anchor Link

backlink-audit-disavow-countersCopy Anchor Link

backlink-audit-disavow-importCopy Anchor Link

backlink-audit-move-domainsCopy Anchor Link

backlink-audit-move-linksCopy Anchor Link

backlink-audit-move-networksCopy Anchor Link

backlink-audit-disavow-moveCopy Anchor Link

backlink-audit-disavow-deleteCopy Anchor Link

backlink-audit-disavow-clearCopy Anchor Link

backlink-audit-target-pagesCopy Anchor Link

backlink-audit-target-pages-countCopy Anchor Link

backlink-audit-tagsCopy Anchor Link

backlink-audit-tag-countsCopy Anchor Link

backlink-audit-target-tag-addCopy Anchor Link

backlink-audit-target-tag-removeCopy Anchor Link

backlink-audit-tag-deleteCopy Anchor Link

backlink-audit-commentsCopy Anchor Link

backlink-audit-comment-saveCopy Anchor Link

backlink-audit-comment-deleteCopy Anchor Link

backlink-audit-rerunCopy Anchor Link

backlink-audit-exportCopy Anchor Link

backlink-audit-importCopy Anchor Link

backlink-audit-replace-scopeCopy Anchor Link

On this page

backlink-audit-limits

backlink-audit-campaigns

backlink-audit-categories

backlink-audit-countries

backlink-audit-project

backlink-audit-scopes

backlink-audit-info

backlink-audit-status

backlink-audit-links-summary

backlink-audit-domains-summary

backlink-audit-anchor-types

backlink-audit-rel-summary

backlink-audit-removed-summary

backlink-audit-historical-stats

backlink-audit-authority-history

backlink-audit-domains-history

backlink-audit-links-history

backlink-audit-changes

backlink-audit-authority-distribution

backlink-audit-link-types

backlink-audit-anchors

backlink-audit-top-domains

backlink-audit-recommendations

backlink-audit-create

backlink-audit-configure

backlink-audit-disavow-export

backlink-audit-links

backlink-audit-links-count

backlink-audit-link-categories

backlink-audit-disavow

backlink-audit-disavow-count

backlink-audit-disavow-counters

backlink-audit-disavow-import

backlink-audit-move-domains

backlink-audit-move-links

backlink-audit-move-networks

backlink-audit-disavow-move

backlink-audit-disavow-delete

backlink-audit-disavow-clear

backlink-audit-target-pages

backlink-audit-target-pages-count

backlink-audit-tags

backlink-audit-tag-counts

backlink-audit-target-tag-add

backlink-audit-target-tag-remove

backlink-audit-tag-delete

backlink-audit-comments

backlink-audit-comment-save

backlink-audit-comment-delete

backlink-audit-rerun

backlink-audit-export

backlink-audit-import

backlink-audit-replace-scope