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).

Running Without Credentials

If you start this actor without a SEMrush API key, or with Demo Mode enabled, it returns clearly labeled sample data instead of failing. Sample output includes demo: true and a _notice field. Sample runs charge no task events. Add your own API key to receive live data.

---

Before You Start

Do I need a SEMrush account?

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 2: Run with real data

{
    "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
domains	string[]	-	Domains to analyze. Use bare domain format: example.com
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

---

Troubleshooting

"SEMrush API key is required"

• 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

• 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