SEMrush Traffic Analytics - Visits, Sources & Engagement

Pricing

Rating

Developer

Actor stats

Categories

Share

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 Parameters

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

Additional data enrichment events (charged only when enabled):

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