Semrush provides legacy v3 SEO, domain, advertising, and PLA reports alongside v4 backlink and keyword metrics, projects, local listings and reviews, Google Business Profile management, and map rank tracking.
Publish an owner comment to a review that supports replies. This mutation creates a public reply. Requires a Semrush v4 API key and a Local Pro or Business, plus a connected publisher account that permits replies.
DEPRECATED: Please use 'SEMRUSH_V4_BACKLINKS_OVERVIEW' instead. Provides a semicolon-delimited (sep=';') CSV summary of backlinks, including Authority Score and link type breakdowns, for a specified and publicly accessible domain, root domain, or URL. A result of 'ERROR 50 :: NOTHING FOUND' means the target has no data in the database and is a valid zero-result response.
DEPRECATED: Please use 'SEMRUSH_V4_BACKLINKS_COMPARISON' instead. Compares backlink profiles for multiple specified targets (domains, subdomains, or URLs) to analyze and compare link-building efforts.
DEPRECATED: Semrush has deprecated this v3 report; no v4 equivalent exists. Fetches a keyword overview report from a Semrush regional database for up to 100 keywords, providing metrics like search volume, CPC, and keyword difficulty. Response is CSV-like text (not JSON); parse accordingly. Returns literal string 'ERROR 50 :: NOTHING FOUND' for keywords with no data in the selected database — treat as zero results and fall back to SEMRUSH_KEYWORD_OVERVIEW_ONE_DATABASE or SEMRUSH_KEYWORD_OVERVIEW_ALL_DATABASES for those terms.
DEPRECATED: Semrush has deprecated this v3 report; no v4 equivalent exists. Fetches broad match keywords for a given phrase. Response is CSV-like text (not JSON); parse by splitting on line breaks and delimiters. `display_sort` and `display_filter` parameters are defined but currently not utilized by the API call.
Fetch remaining Semrush Standard API units for a legacy v3 connection. This documented balance request is free. Use it before large paid report batches to fail fast when units are exhausted or below a required threshold.
Start a data-collection mutation that creates a new campaign report. This consumes Map Rank Tracker credits equal to points multiplied by keywords. Requires a Semrush v4 API key with Read and write permission. Map-specific docs say no special subscription or Standard API units are required; the general API FAQ still requires an eligible subscription.
Analyzes keyword rankings by comparing up to five domains to find common, unique, or gap keywords, using specified organic/paid types and comparison logic in the `domains` string.
Compare v4 backlink summaries for up to ten targets. Select a Semrush connection configured with a v4 API key. `format=json` returns typed `meta` and `data`; `format=csv` returns raw semicolon-delimited text in `csv`. The nominal published price is 40 API units per returned line. This API is in Early Access and currently bills at v3 rates; pricing may change.
Create a Semrush Listing Management location. HTTP success starts asynchronous provisioning; poll Get Listing Management location until its status is COMPLETED or FAILED, which may take up to seven days. Supply at least one location body field. Use the validation action to check a payload without creating. Create locations sequentially; Semrush does not support concurrent create requests and may return 429. Requires a v4 key with Read and write permission and Local Pro or Business. This family does not consume Standard API units.
Add a base64-encoded JPEG or PNG image to a Semrush Listing Management location using a read-write v4 key and Local Pro or Business.
Create persistent Map Rank Tracker campaign data. Requires a Semrush v4 API key with Read and write permission. Map-specific docs say no special subscription or Standard API units are required; the general API FAQ still requires an eligible subscription.
Create a draft, scheduled, or ready-to-send GBP post. Either content or image_urls must be supplied. Requires EDIT or OWNER rights for an active Semrush location with a Google Business Profile connection.
Create a Semrush v4 project for a domain. Select a Semrush connection configured with a v4 Read and write API key. This operation returns typed JSON `meta` and `data`; CSV is not supported. Semrush publishes no nominal per-operation unit price for this Projects API operation.
Permanently delete an eligible location using a read-write v4 key and Local plan.
Permanently delete an image using a read-write v4 key and Local plan.
Permanently delete a campaign and all its collected data. This destructive mutation cannot be undone. Requires a Semrush v4 API key. Requires Read and write permission. Map-specific docs say no special subscription or Standard API units are required; the general API FAQ still requires an eligible subscription.
Permanently delete a DRAFT, SCHEDULED, or TO_SEND GBP post. Requires EDIT or OWNER rights; posts for frozen or canceled locations cannot be deleted.
Permanently remove a public review comment. This destructive mutation cannot be undone. Requires a Semrush v4 API key and Local Pro or Business, plus a connected publisher account that permits comment removal.
Permanently delete a Semrush v4 project and all associated data. Select a Semrush connection configured with a v4 Read and write API key. This operation returns typed JSON `meta` and `data`; CSV is not supported. Semrush publishes no nominal per-operation unit price for this Projects API operation.
Stop distribution for a controllable listing; a parent may affect child listings. Requires a read-write v4 key and Local Pro or Business.
Resume distribution for a controllable disconnected listing. Requires a read-write v4 key and Local Pro or Business.
DEPRECATED: Semrush has deprecated this v3 report; no v4 equivalent exists. Call this to find related keywords (including synonyms and variations) for a target phrase in a specific regional database; `display_date` (if used for historical data) must be 'YYYYMM15' for a past month. Response is CSV-like delimited text (not JSON); parse by splitting on newlines and delimiters to extract structured rows.
Retrieves unique ad copies Semrush has observed for a specified domain from a regional database, detailing ads seen in Google's paid search results. Results are a sampled subset, not a complete picture of the domain's advertising. Response is returned as a CSV-like string; parse columns (e.g., Tt, Ds) using the pipe or semicolon delimiter.
DEPRECATED: Please use 'SEMRUSH_V4_ANCHORS' instead. Use this action to get a CSV report of anchor texts for backlinks pointing to a specified, publicly accessible domain, root domain, or URL.
DEPRECATED: Please use 'SEMRUSH_V4_AUTHORITY_SCORE_PROFILE' instead. Retrieves the Authority Score (AS) profile for a specified target, showing the count of referring domains that link to the target for each AS value from 0 to 100.
DEPRECATED: Please use 'SEMRUSH_V4_BACKLINKS' instead. Fetches backlinks for a specified domain or URL as a semicolon-delimited CSV string (parse with `sep=';'`); allows customization of columns, sorting, and filtering. Consumes Semrush API credits per request. Ensure `display_limit` surpasses `display_offset` when an offset is used, and note the `urlanchor` filter may have limitations for targets with extensive backlinks.
DEPRECATED: Semrush has deprecated this v3 report; no v4 equivalent exists. Retrieves categories and their 0-1 confidence ratings for a specified domain, subdomain, or URL, with results sorted by rating. Response is returned as semicolon-separated text in a single 'data' field requiring parsing before use. Some niche or atypical targets may return no category data.
DEPRECATED: Semrush has deprecated this v3 report; no v4 equivalent exists. Retrieves a profile of content categories from referring domains for a specified target, analyzing its first 10,000 referring domains and sorting results by domain count.
DEPRECATED: Please use 'SEMRUSH_V4_BACKLINK_COMPETITORS' instead. Retrieves a CSV-formatted report of competitors for a specified target (root domain, domain, or URL) based on shared backlinks or referring domains. Output is a CSV string; use display_limit and display_offset to paginate without silent truncation.
Use to get a domain's organic search competitors from Semrush as a semicolon-separated string; `display_date` requires 'YYYYMM15' format if used.
Retrieves a list of a domain's competitors in paid search results from a specified regional database.
Retrieves a domain's 12-month advertising history from Semrush (keywords bid on, ad positions, ad copy) for PPC strategy and competitor analysis; most effective when the domain has ad history in the selected database.
Fetches a report on a domain's unique organic pages ranking in Google's top 100 search results, with options for specifying database, date, columns, sorting, and filtering. Response is semicolon-separated CSV text in a single `data` field requiring explicit parsing. The literal response `ERROR 50 :: NOTHING FOUND` means zero results for that domain/database combination, not a system error. Traffic metrics (e.g., `Tr`) are modeled estimates incompatible with first-party analytics data.
Retrieves an organic search keyword report for a domain from a selected Semrush regional database. Choose report columns, date and sort order, and use the limit and offset to page through results. The report is returned as text and requires a Semrush v3 connection.
Retrieves a report on subdomains of a given domain that rank in Google's top 100 organic search results for a specified regional database.
Fetches keywords driving paid search traffic to a specified, existing domain using a supported Semrush regional database.
DEPRECATED: Please use 'SEMRUSH_V4_BACKLINKS_HISTORICAL_SUMMARY' instead. Retrieves monthly historical backlink and referring domain data for a specified root domain, returned as a time series string with newest records first.
DEPRECATED: Retrieves a Semrush indexed-pages report for a specified root domain, domain, or URL and target type. Returns CSV-like text for parsing.
DEPRECATED: Please use 'SEMRUSH_V4_KEYWORD_METRICS' instead. Determines the Keyword Difficulty (KD) score (0-100, higher means greater difficulty) for a given phrase in a specific Semrush regional database to assess its SEO competitiveness. Returns CSV-formatted text; parse before programmatic use.
DEPRECATED: Please use 'SEMRUSH_V4_KEYWORD_METRICS' instead. Fetches a keyword summary for a specified phrase from a chosen regional database. Returns CSV-like text (not JSON) with column headers matching `export_columns` codes (e.g., 'Ph', 'Nq', 'Kd'); parse headers and rows into structured data before use. A plain-text 'ERROR 50 :: NOTHING FOUND' response indicates zero results, not a transport error.
DEPRECATED: Semrush has deprecated this v3 report; no v4 equivalent exists. Fetches a historical report (last 12 months) of domains advertising on a specified keyword in Google Ads, optionally for a specific month ('YYYYMM15') or the most recent period, returning raw CSV-like data.
Get one Listing Management location using a v4 key and Local Pro or Business.
Get one Map Rank Tracker campaign without consuming API units. Requires a Semrush v4 API key. Map-specific docs say no special subscription or Standard API units are required; Semrush's general API FAQ still requires an eligible subscription.
Get a campaign heatmap for one keyword and report timestamp. Requires a Semrush v4 API key. Map-specific docs say no special subscription or Standard API units are required; the general API FAQ still requires an eligible subscription.
Get campaign keyword statuses for the latest or a specified report. Requires a Semrush v4 API key. Map-specific docs say no special subscription or Standard API units are required; the general API FAQ still requires an eligible subscription.
Get average-position and share-of-voice history for one keyword. Requires a Semrush v4 API key. Map-specific docs say no special subscription or Standard API units are required; the general API FAQ still requires an eligible subscription.
Get campaign-slot and monthly Map Rank Tracker credit limits. Requires a Semrush v4 API key. Map-specific docs say no special subscription or Standard API units are required; the general API FAQ still requires an eligible subscription.
DEPRECATED: Semrush has deprecated this v3 report; no v4 equivalent exists. Retrieves up to 100,000 domains and URLs from Google's top 100 organic search results for a keyword and region, returning a raw string; use `display_date` in 'YYYYMM15' format (day must be '15') for historical data.
DEPRECATED: Semrush has deprecated this v3 report; no v4 equivalent exists. Fetches domains ranking in Google's paid search results (AdWords) for a specified keyword and regional database.
Retrieves domains competing with a specified domain in Google's Product Listing Ads (PLA) from a given Semrush regional database.
Fetches Product Listing Ad (PLA) copies that Semrush observed for a domain in Google's paid search results.
Retrieves Product Listing Ad (PLA) search keywords for a specified domain from a Semrush regional database.
DEPRECATED: Please use 'SEMRUSH_V4_REFERRING_DOMAINS' instead. Retrieves a semicolon-delimited text report listing domains that link to a target, with options to filter by type (not value). Parse with sep=';' and cast numeric columns (e.g., backlinks_num, domain_ascore) before aggregating.
DEPRECATED: Semrush has deprecated this v3 report; no v4 equivalent exists. Generates a CSV report detailing the geographic distribution of referring domains (by country, determined via IP address) for a specified, publicly accessible target.
Return GBP metrics for up to five locations. Provide at least one of `aggregated_metrics` or `total_metrics`. Requires a Semrush v4 API key and Local Pro or Business. Each location requires a Google Business Profile connection. Semrush does not document the total_metrics response shape, so that field remains untyped.
Return review auto-reply settings for a location. Requires a Semrush v4 API key, Local Pro or Business, and a GBP connection.
Return review counts, rating distribution, and reply statistics. Requires a Semrush v4 API key, Local Pro or Business, and a GBP connection.
DEPRECATED: Semrush has deprecated this v3 report; no v4 equivalent exists. Fetches a report on the Top-Level Domain (TLD) distribution of referring domains for a specified target, useful for analyzing geographic or categorical backlink diversity.
Get the v4 referring-domain authority-score distribution. Select a Semrush connection configured with a v4 API key. `format=json` returns typed `meta` and `data`; `format=csv` returns raw semicolon-delimited text in `csv`. The nominal published price is 1 API unit per returned line. This API is in Early Access and currently bills at v3 rates; pricing may change.
Get monthly v4 backlink history for a URL or domain. Select a Semrush connection configured with a v4 API key. `format=json` returns typed `meta` and `data`; `format=csv` returns raw semicolon-delimited text in `csv`. The nominal published price is 40 API units per returned line. This API is in Early Access and currently bills at v3 rates; pricing may change.
Compare shared referring domains and backlinks for up to six targets. Select a Semrush connection configured with a v4 API key. This operation returns typed JSON `meta` and `data` only; CSV is not supported. The nominal published price is 40 API units per returned line. This API is in Early Access and currently bills at v3 rates; pricing may change.
Get aggregated v4 backlink metrics for a URL or domain. Select a Semrush connection configured with a v4 API key. `format=json` returns typed `meta` and `data`; `format=csv` returns raw semicolon-delimited text in `csv`. The nominal published price is 45 API units per request. This API is in Early Access and currently bills at v3 rates; pricing may change.
Get Semrush v4 SEO and PPC metrics for one keyword and country. Select a Semrush connection configured with a v4 API key. `format=json` returns typed `meta` and `data`; `format=csv` returns raw semicolon-delimited text in `csv`. The nominal published price is 20 API units per request. This API is in Early Access and currently bills at v3 rates; pricing may change.
Get the full details of one accessible Semrush v4 project. Select a Semrush connection configured with a v4 API key. This operation returns typed JSON `meta` and `data`; CSV is not supported. Semrush publishes no nominal per-operation unit price for this Projects API operation.
DEPRECATED: Semrush has deprecated this v3 report; no v4 equivalent exists. Fetches a keyword overview from Semrush for a specified phrase, including metrics like search volume, CPC, and competition. Response is returned as a CSV-like string; parse headers and rows into a structured table before extracting values like Nq, Cp, or Kd.
List locations using a v4 key and Local Pro or Business; uses no API units.
List Semrush Local business categories supported for a country. Requires a v4 key and Local Pro or Business and uses no Standard API units.
List location images using a v4 key and Local Pro or Business.
Get directory listings using a v4 key and Local Pro or Business.
Get payment options using a v4 key and Local Pro or Business.
List and filter Map Rank Tracker campaigns without consuming API units. Requires a Semrush v4 API key. Map-specific docs say no special subscription or Standard API units are required; the general API FAQ still requires an eligible subscription.
Get a paginated competitor ranking for one keyword and report. Requires a Semrush v4 API key. Map-specific docs say no special subscription or Standard API units are required; the general API FAQ still requires an eligible subscription.
Return additional business-hour types available for a GBP location. Requires a Semrush v4 API key and Local Pro or Business. An active Google Business Profile connection is required for the location.
Return GBP attributes and allowed values for a category and country. Requires a Semrush v4 API key and Local Pro or Business.
Return GBP categories supported in a country. Requires a Semrush v4 API key and Local Pro or Business.
Return filtered GBP posts for one or more Semrush locations. Requires a Semrush v4 API key and Local Pro or Business. An active Google Business Profile connection is required for each location.
Return GBP data-change suggestions for one or more active locations. The request fails if any location lacks a GBP connection or is frozen or canceled.
Return a filtered, paginated list of reviews for a Semrush location. Requires a Semrush v4 API key, Local Pro or Business, and a GBP connection.
List v4 backlink anchors for a URL or domain. Select a Semrush connection configured with a v4 API key. `format=json` returns typed `meta` and `data`; `format=csv` returns raw semicolon-delimited text in `csv`. The nominal published price is 40 API units per returned line. This API is in Early Access and currently bills at v3 rates; pricing may change.
List v4 backlink competitors based on referring-domain overlap. Select a Semrush connection configured with a v4 API key. `format=json` returns typed `meta` and `data`; `format=csv` returns raw semicolon-delimited text in `csv`. The published nominal price is 40 API units per returned line. This API is in Early Access and currently bills at v3 rates; pricing may change.
List v4 backlinks with field selection, filtering, sorting, and pagination. Select a Semrush connection configured with a v4 API key. `format=json` returns typed `meta` and `data`; `format=csv` returns raw semicolon-delimited text in `csv`. The nominal published price is 45 API units per returned line. This API is in Early Access and currently bills at v3 rates; pricing may change.
List v4 indexed backlink pages for a URL or domain. Select a Semrush connection configured with a v4 API key. `format=json` returns typed `meta` and `data`; `format=csv` returns raw semicolon-delimited text in `csv`. The nominal published price is 40 API units per returned line. This API is in Early Access and currently bills at v3 rates; pricing may change.
List Semrush v4 projects by ownership or sharing scope. Select a Semrush connection configured with a v4 API key. This operation returns typed JSON `meta` and `data`; CSV is not supported. Semrush publishes no nominal per-operation unit price for this Projects API operation.
List v4 referring domains for a URL or domain. Select a Semrush connection configured with a v4 API key. `format=json` returns typed `meta` and `data`; `format=csv` returns raw semicolon-delimited text in `csv`. The nominal published price is 40 API units per returned line. This API is in Early Access and currently bills at v3 rates; pricing may change.
List v4 referring IP addresses for a URL or domain. Select a Semrush connection configured with a v4 API key. `format=json` returns typed `meta` and `data`; `format=csv` returns raw semicolon-delimited text in `csv`. The nominal published price is 20 API units per returned line. This API is in Early Access and currently bills at v3 rates; pricing may change.
Start accepting or rejecting an open GBP suggestion. Poll List GBP Suggestions until the status becomes ACCEPTED, REJECTED, or FAILED. Accepting a GBP_USER_EDIT may also close a paired GBP_DATA_MISMATCH suggestion for the same field. Requires EDIT or OWNER rights on an active location.
DEPRECATED: Semrush has deprecated this v3 report; no v4 equivalent exists. Fetches question-format keywords semantically related to a given query phrase for a specified regional database, aiding in understanding user search intent and discovering content ideas.
DEPRECATED: Please use 'SEMRUSH_V4_REFERRING_IPS' instead. Fetches IP addresses that are sources of backlinks for a specified target domain, root domain, or URL.
Replace all review auto-reply settings for a location. This mutation is a full replacement: fields omitted by the caller are reset to the Semrush defaults represented by the request model, rather than left unchanged. Enabling settings can publish future replies automatically. Requires a Semrush v4 API key with Read and write permission, Local Pro or Business, and a GBP connection.
Patch selected fields on a Semrush Listing Management location. Use the validation action to check an update without applying it. Requires a v4 key with Read and write permission and Local Pro or Business. This family does not consume Standard API units.
Replace a location image caption using a read-write v4 key and Local Pro or Business.
Mutate selected settings of an existing Map Rank Tracker campaign. Provide at least one of `keywords`, `name`, `grid_settings`, `points`, or `collecting_frequency`. Requires a Semrush v4 API key with Read and write permission. Map-specific docs say no special subscription or Standard API units are required; the general API FAQ still requires an eligible subscription.
Update a DRAFT, SCHEDULED, or TO_SEND GBP post. Only fields named by update_mask are changed. Requires EDIT or OWNER rights; frozen or canceled locations cannot be updated.
Replace the public text of an editable review comment. This mutation changes a published reply. Requires a Semrush v4 API key and a Local Pro or Business, plus a connected publisher account that permits comment editing.
Rename a Semrush v4 project. Select a Semrush connection configured with a v4 Read and write API key. This operation returns typed JSON `meta` and `data`; CSV is not supported. Semrush publishes no nominal per-operation unit price for this Projects API operation.
Validate a Listing Management location payload without creating it or consuming a Local Pro location limit. Supply at least one location body field. Requires a read-write v4 key.
Validate selected changes to a Listing Management location without applying them. Requires a read-write v4 key and Local Pro or Business.
The Semrush integration connects your Dench AI CRM directly to Semrush, so agents can read and act on your Semrush data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.
98 actions are available for agents to invoke on your behalf. Every call runs through Semrush's own authorization, scoped to the account you connect.
Sign in to your Dench workspace and open Integrations.
Find Semrush and click Connect — you'll authorize access through Semrush's own sign-in flow. No API keys or code required.
Ask an agent to use Semrush in chat, or call it from an automation.
Manage or disconnect the connection any time from workspace settings.
The Dench Semrush integration connects your AI CRM to Semrush, so AI agents can work with your Semrush data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.
The Semrush integration currently exposes 98 actions, including Add Semrush review comment, Backlinks overview, Batch comparison, Batch keyword overview, Broad match keyword, and Check Semrush account units balance. Agents invoke them on your behalf from chat or from automations.
No. You connect Semrush from your Dench workspace using Semrush's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.
Connections are authorized through Semrush's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the Semrush connection from your workspace settings at any time.