Semrush Integration | Chipp Docs

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

Create a v4 API key

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.

Open Integrations

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

Paste your key

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.

Try it

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.