SEMrush Traffic Analytics - Visits, Sources & Engagement

Get comprehensive website traffic data from SEMrush: monthly visits, unique visitors, bounce rate, pages per visit, visit duration, traffic source breakdown, geographic distribution, and 12-month trend history.

BYOK (Bring Your Own Key) - you need a SEMrush API key with Traffic Analytics access (Guru or Business plan).

---

Before You Start

Do I need a SEMrush account?

Yes. This actor uses your SEMrush API key to fetch data. You can test with Demo Mode first (free, no key needed), but real data requires a paid SEMrush plan.

Which SEMrush plan do I need?

Traffic Analytics API access requires SEMrush Guru ($129/mo) or Business ($499/mo). The free and Pro plans do NOT include Traffic Analytics.

Where do I find my API key?

1. Log in to semrush.com
2. Click your profile icon (top right)
3. Go to Subscription Info
4. Your API key is listed under "API units"
5. Copy the key and paste it into the SEMrush API Key field below

---

Quick Start

Step 1: Test with Demo Mode (free)

Run this to see sample output with no API key required:

{
    "demoMode": true,
    "domains": ["amazon.com", "shopify.com"]
}

Step 2: Run with real data

Turn off Demo Mode and add your SEMrush API key:

{
    "demoMode": false,
    "semrushApiKey": "YOUR_SEMRUSH_API_KEY_HERE",
    "domains": ["competitor1.com", "competitor2.com"],
    "includeHistorical": true,
    "includeTrafficSources": true,
    "includeGeoDistribution": true
}

Domain Format

Use bare domains only. The actor will clean up common mistakes, but for best results:

Input	Result
amazon.com	Works
www.amazon.com	Works (www stripped)
https://amazon.com	Works (protocol stripped)
https://amazon.com/products?page=1	Works (path stripped)
not a domain	Skipped with warning

---

Input Parameters

Parameter	Type	Default	Description
semrushApiKey	string	-	Your SEMrush API key (required when Demo Mode is off)
domains	string[]	-	Domains to analyze. Use bare domain format: example.com
demoMode	boolean	true	Return sample data without using API. Turn this OFF for real data.
includeHistorical	boolean	true	Include 12-month traffic trend
includeTrafficSources	boolean	true	Break down by source (direct, search, social, referral, paid, email)
includeGeoDistribution	boolean	true	Break down by country
geoLimit	integer	10	Max countries to include (1-50)
webhookUrl	string	-	Optional: send results to Zapier, Make, n8n, or custom webhook
webhookPlatform	string	custom	Webhook format: zapier, make, n8n, or custom

---

Output Format

Each domain produces one result object in the dataset:

{
    "domain": "amazon.com",
    "totalVisits": 2847000000,
    "uniqueVisitors": 1234000000,
    "pagesPerVisit": 8.42,
    "avgVisitDuration": "7:23",
    "avgVisitDurationSeconds": 443,
    "bounceRate": "34.2%",
    "bounceRateValue": 0.342,
    "trafficSources": {
        "direct": 0.41,
        "search": 0.28,
        "social": 0.04,
        "referral": 0.15,
        "paid": 0.09,
        "mail": 0.03
    },
    "geoDistribution": [
        { "country": "United States", "countryCode": "US", "trafficShare": 0.35, "visits": 996450000 },
        { "country": "United Kingdom", "countryCode": "GB", "trafficShare": 0.08, "visits": 227760000 }
    ],
    "historicalData": [
        { "date": "2025-01", "visits": 2650000000, "uniqueVisitors": 1150000000, "pagesPerVisit": 8.1, "bounceRate": 0.35 },
        { "date": "2025-02", "visits": 2720000000, "uniqueVisitors": 1180000000, "pagesPerVisit": 8.3, "bounceRate": 0.34 }
    ],
    "analysisDate": "2026-04-22T12:00:00.000Z",
    "apiUnitsUsed": 200
}

Traffic source values

Traffic source shares are decimals (0.0 to 1.0), NOT percentages. Multiply by 100 for display:

• 0.41 = 41% direct traffic
• 0.28 = 28% search traffic

---

Pricing

Event	When	Price
Domain analyzed	Each domain successfully processed	$0.05

Additional data enrichment events (charged only when enabled):

Event	When	Price
Traffic sources fetched	Per domain when includeTrafficSources is on	$0.02
Geo distribution fetched	Per domain when includeGeoDistribution is on	$0.02
Historical data fetched	Per domain when includeHistorical is on	$0.02
Webhook sent	When webhook URL is provided	$0.01

Cost per domain with all options: $0.11

Demo mode is free - no charges for sample data.

---

Troubleshooting

"SEMrush API key is required"

You have Demo Mode turned off but didn't provide an API key. Either:

• Turn Demo Mode on to test with sample data, OR
• Add your SEMrush API key in the input

"API key is invalid or your plan does not include Traffic Analytics"

Your SEMrush plan doesn't include Traffic Analytics API access. You need Guru ($129/mo) or Business ($499/mo). The free and Pro plans don't work.

"No traffic data available for [domain]"

SEMrush doesn't have traffic data for very small or very new websites. This is a SEMrush data coverage limitation, not an actor bug. Try a larger/more established domain.

"Rate limit hit"

You're analyzing too many domains too quickly. The actor adds delays between requests, but if you're running multiple instances simultaneously, wait a minute and try again.

All domains show 0 visits

• Make sure Demo Mode is off (if on, you get sample data, not zeros)
• Verify your API key has Traffic Analytics access
• Try a well-known domain like amazon.com to confirm the key works

---

Use Cases

• Competitive benchmarking - Compare your traffic against competitors
• Market research - Understand traffic patterns in your industry
• Investment due diligence - Analyze traffic for potential acquisitions
• Client reporting - Generate traffic reports for agency clients
• Geographic targeting - Identify top markets by country
• Trend analysis - Track 12-month traffic history for seasonality

---

Built by John Rippy | Actor Arsenal