# Semrush Integration

Let your AI agent research keywords, check rankings, read Site Audit results and find backlinks with your own Semrush account, then hand approved fixes to your site editor.

---

Connect your own Semrush account to your Chipp AI so it can research keywords, check where your site ranks, read your Site Audit and Position Tracking results, and tell you what to fix first -- all through natural conversation.

This is part of Chipp's SEO and AEO (answer engine optimization) toolkit. The agent only recommends changes. You approve each one, and approved changes go to your normal Builder / site-edit workflow. Nothing is published automatically.

## Before you start

Semrush's API is part of the paid Semrush plans. You need:

- A Semrush account on the **SEO Business** plan.
- **API units** on that account. Semrush sells them separately, and a new upgrade starts with zero. Every call your AI makes uses units from your account.
- A **Version 4 (v4) API key** from your Semrush profile.

Chipp does not hold a Semrush key for you and never uses one of its own. Everything runs on your plan and your units.

## What the AI Can Do

Once connected, your agent gains these tools:

| Tool | What it does | API units |
|------|--------------|-----------|
| **semrush_domain_overview** | Traffic estimate, keyword position buckets, gained and lost keywords, and a monthly trend | 10 + 10 per trend month |
| **semrush_organic_keywords** | The keywords a site ranks for, including page-two keywords close to page one and keywords that dropped | 10 per row |
| **semrush_organic_competitors** | Sites that rank for the same keywords | 40 per row |
| **semrush_keyword_metrics** | Volume, difficulty, CPC, intent and SERP features (including AI Overviews) for up to 5 keywords | 20 per keyword |
| **semrush_keyword_ideas** | Related or broad-match keyword ideas, filtered by volume and difficulty | 40 per row |
| **semrush_backlink_profile** | Authority Score, backlinks, top referring domains, new and lost links, and history | 45 + 40 per domain + 40 per month |
| **semrush_site_audit_list** | Your Site Audit campaigns, when they last ran, and live crawl progress | Free |
| **semrush_site_audit_report** | The latest audit: site health, thematic scores, top issues and what changed | 10,000 |
| **semrush_site_audit_issues** | The pages affected by one audit issue | 100 per row |
| **semrush_site_audit_start** | Start a new Site Audit crawl in your Semrush project (needs a read and write key) | 100 |
| **semrush_tracking_campaigns** | Your Position Tracking campaigns | Free |
| **semrush_tracking_summary** | How rankings changed between two dates: top 3, 10, 20, 50 and 100, visibility and a trend | 20 to 120 |
| **semrush_tracking_keywords** | Tracked keywords that moved up or down | 100 per row |

Every result is trimmed to the useful evidence, with a ranked list of what to fix first and why. Each result also says when its data is from, how many units it can have used, and whether anything is missing.

## Connecting Semrush


  **1.** 
    <strong>Create a v4 API key</strong>

    In Semrush, open your profile, then **API keys**, and create a **Version 4** key. Read-only is enough for everything except starting a new Site Audit. Chipp shows the exact steps in the connect dialog.
  


  **2.** 
    <strong>Open Integrations</strong>

    In your app's builder, go to **Brain > Integrations** and find **Semrush** (under **SEO & AEO**).
  


  **3.** 
    <strong>Paste your key</strong>

    Paste the key into **Semrush API key (v4)** and click **Connect**. Chipp checks the key with Semrush before saving it. The check costs no API units. If Semrush rejects the key, or your plan does not include the API, Chipp tells you and saves nothing.
  


  **4.** 
    <strong>Try it</strong>

    Ask your agent:
    - "Which keywords is example.com on page two for? What should I fix first?"
    - "Compare my rankings now with a month ago"
    - "Check the latest Site Audit and list the biggest problems"
  


## Whose credentials are used

You bring your own key.

- Calls use **your Semrush plan and API units** and show up in your Semrush account.
- The key is stored encrypted, belongs to your app, and is never shown again or sent to the AI model.
- To stop access, disconnect the integration in **Brain > Integrations**. Chipp deletes the stored key. You can also delete the key on the Semrush API keys page. To use a different key, disconnect and connect again.

## Spending API units

Some Semrush reports are expensive. Before it runs anything that can cost more than 500 units, your AI tells you the cost and waits for your approval. A full Site Audit report costs 10,000 units, so it always asks first. Starting a new Site Audit also needs your go-ahead.

## Re-checking your results

Semrush keeps the history, so there is nothing to save. Ask for the monthly trend, the Authority Score history, the Site Audit changes since the previous audit, or a Position Tracking comparison between two dates. Chipp does not store any Semrush data.

## Limits

- **Plan required.** The SEO API, Projects API, Site Audit and Position Tracking need SEO Business and API units. Without them the AI tells you Semrush refused the request.
- **Monthly snapshots.** Domain and keyword data are monthly snapshots, and traffic figures are Semrush estimates, not your own analytics. Backlink counts will differ from Google Search Console.
- **Set up in Semrush first.** Site Audit and Position Tracking only show projects and campaigns you created in Semrush.
- **Stale data is flagged.** If a snapshot, audit or tracking date is old, the AI says so.
- **Rate limit.** Semrush allows 10 requests per second per account.
- **Recommendations only.** The integration never edits or publishes your site. Starting a Site Audit only starts a crawl inside Semrush.

## Troubleshooting

| Message | What to do |
|---------|-----------|
| Semrush rejected this API key | Create a new v4 key, disconnect, and connect again |
| Semrush refused this key (403) | Check that the account is on SEO Business with API units, and that the key is v4. Starting an audit needs a read and write key |
| No API units left | Buy more units in Semrush under Subscription info, then API Units |
| Request rate is too high | Wait a few seconds and ask again |
| No Site Audit campaign or tracking campaign found | Set one up for your site in Semrush, then ask again |
| Blocked by Semrush's security system | Do not retry. Contact Semrush support and quote the request id the AI shows |

## Billing

Semrush tool calls use your standard Chipp LLM token billing. Semrush's own usage is governed by your Semrush plan and API units.