# Semrush AI integration on Definable

> Semrush is a popular SEO tool suite that specializes in keyword research, competitor analysis, and Google Ad campaign optimization.

## What this connects

Semrush is a popular SEO tool suite that specializes in keyword research, competitor analysis, and Google Ad campaign optimization.

Vendor: https://www.semrush.com/

## Tools available

**37** tools available. First 12:

- `SEMRUSH_ACCOUNT_UNITS_BALANCE` — Check Semrush account units balance — Tool to fetch the remaining Semrush Standard API units for the authenticated account. Use this before launching large batches of Semrush report requests to preflight and fail fast if units are exhausted or below a required threshold.
- `SEMRUSH_ADS_COPIES` — Get ad copies — 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.
- `SEMRUSH_ANCHORS` — Get anchor texts — Use this action to get a CSV report of anchor texts for backlinks pointing to a specified, publicly accessible domain, root domain, or URL.
- `SEMRUSH_AUTHORITY_SCORE_PROFILE` — Get authority score profile — 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.
- `SEMRUSH_BACKLINKS` — Get backlinks — 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.
- `SEMRUSH_BACKLINKS_OVERVIEW` — Backlinks overview — 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.
- `SEMRUSH_BATCH_COMPARISON` — Batch comparison — Compares backlink profiles for multiple specified targets (domains, subdomains, or URLs) to analyze and compare link-building efforts.
- `SEMRUSH_BATCH_KEYWORD_OVERVIEW` — Batch keyword overview — 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.
- `SEMRUSH_BROAD_MATCH_KEYWORD` — Broad match keyword — 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.
- `SEMRUSH_CATEGORIES` — Get categories — 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.
- `SEMRUSH_CATEGORIES_PROFILE` — Get categories profile — 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.
- `SEMRUSH_COMPETITORS` — Get competitor data — 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.

## Auth

Auth schemes: `API_KEY`.

## How agents use Semrush

Inside a Definable workflow, Semrush is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Semrush** — the Researcher (GPT-5.5) pulls context from Semrush (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Semrush** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Semrush (create record, post message, draft email).
- **Designer / Engineer → Distributor → Semrush** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Semrush (attach file, open PR comment, post status).

The Verifier checks every Semrush call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- marketing — https://definable.ai/apps/category/marketing/
- analytics — https://definable.ai/apps/category/analytics/

## Related

- HTML page: https://definable.ai/apps/semrush/
- Same category (marketing): https://definable.ai/apps/category/marketing/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt