SEMrush Site Audit - Technical SEO Analysis with Auto-Cleanup

What is SEMrush?

SEMrush is a leading SEO and digital marketing platform used by over 10 million marketers. This actor connects to the official SEMrush API to extract data.

Important: You need a SEMrush account with API access. The API is available on Business plans and higher.

How to Get Your SEMrush API Key

1. Log in to SEMrush
2. Go to your profile (top right) → Subscription Info
3. Find your API key in the API section
4. Copy the key and paste it in the semrushApiKey field

---

Run SEMrush Site Audits using your own API key. Automatically creates a project, runs a comprehensive technical SEO audit, extracts all issues, and optionally deletes the project to save your quota. Perfect for agencies and consultants who need one-off audits without using up project slots.

Features

Technical SEO Analysis

• Health Score: Overall site health (0-100)
• Errors: Critical issues (5xx, 4xx, broken links, mixed content)
• Warnings: Important issues (missing meta, slow pages, redirect chains)
• Notices: Minor issues (multiple H1s, thin content)

Smart Automation

• Auto-Cleanup: Delete project after audit to save quota
• Existing Projects: Use an existing project instead of creating new
• Wait or Fire-and-Forget: Wait for completion or return immediately
• Configurable Crawl: Set page limits and subdomain options

Integration Ready

• Webhook Support: Zapier, Make, n8n, or custom endpoints
• Structured Output: Clean JSON for automation workflows
• API Units Tracking: Know how many SEMrush units you used

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Type	Default	Description
semrushApiKey	string	-	Your SEMrush API key (required for real audits)
domain	string	-	Domain to audit (e.g., example.com)
projectName	string	auto	Custom project name
existingProjectId	string	-	Use existing project instead of creating new
pageLimit	integer	500	Pages to crawl (100-20,000)
crawlSubdomains	boolean	false	Include subdomains
deleteProjectAfter	boolean	true	Delete project to save quota
waitForCompletion	boolean	true	Wait for audit to finish
maxWaitMinutes	integer	30	Max wait time for completion
issueTypes	array	all	Filter: errors, warnings, notices
webhookUrl	string	-	Webhook endpoint
webhookPlatform	string	custom	zapier, make, n8n, custom
demoMode	boolean	true	Return sample data (no API call)

Output Format

{
  "data": [...]
}

Pricing

This actor uses pay-per-event billing:

Event	Description	Price
Actor start	Base cost per run	$0.10
Audit launched	Per audit started	$0.25
Audit completed	Per successful audit	$0.25
Project deleted	Per cleanup	$0.05

Note: You also use your own SEMrush API units.

Use Cases

Agency Client Audits

Run audits for multiple clients without filling up your project quota.

Automated Monitoring

Schedule regular audits with webhook notifications.

SEO Reporting

Extract structured data for client reports.

Competitive Analysis

Audit competitor sites one-off without permanent tracking.

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal