SEMrush Content Gap Analysis - Find Missing Keyword Opportunities

Discover content gaps - keywords competitors rank for that you don't. Find untapped keyword opportunities with traffic potential, prioritized by volume and difficulty. Build data-driven content strategies based on proven competitor rankings. BYOK (Bring Your Own Key) - use your SEMrush API key.

Features

• Gap Analysis Types - Missing, weak, untapped, strong, and all keyword gaps
• Multi-Competitor Comparison - Compare against up to 4 competitors simultaneously
• Volume & Difficulty Filters - Focus on achievable, high-value keywords
• Traffic Potential Scoring - Estimated traffic if you ranked
• SERP Feature Opportunities - Identify featured snippet possibilities
• Keyword Clustering - Group related keywords by topic
• Competition Difficulty - How hard to outrank competitors
• Position Gap Analysis - Keywords where you rank lower than competitors
• Quick Win Identification - Low-difficulty keywords with high potential
• 45+ Country Databases - US, UK, DE, FR, and more
• Webhook Support - Async delivery for automation pipelines
• Demo Mode - Test with sample data before going live

Who Should Use This Actor?

Content Strategists

Build content calendars based on proven keyword gaps. Prioritize topics that competitors are winning with traffic data.

SEO Agencies

Show clients specific keyword opportunities they're missing. Create data-backed content recommendations for proposals.

In-House SEO Teams

Identify quick wins and strategic content investments. Stop guessing what content to create next.

Copywriters & Editors

Get keyword-targeted briefs based on competitive analysis. Understand what topics drive traffic in your niche.

E-Commerce SEO Teams

Find product category pages competitors rank for. Identify informational content opportunities around products.

Affiliate Marketers

Discover profitable keywords in your niche. Find lower-competition alternatives to target keywords.

Quick Start

Demo Mode (Free Test)

{
  "demoMode": true
}

Basic Content Gap Analysis

{
  "semrushApiKey": "your_semrush_api_key",
  "yourDomain": "yoursite.com",
  "competitors": ["competitor1.com", "competitor2.com"],
  "database": "us",
  "gapType": "missing",
  "keywordLimit": 100,
  "demoMode": false
}

Find Quick Wins (Low Difficulty)

{
  "semrushApiKey": "your_semrush_api_key",
  "yourDomain": "yoursite.com",
  "competitors": ["competitor1.com", "competitor2.com", "competitor3.com"],
  "database": "us",
  "gapType": "missing",
  "keywordLimit": 200,
  "minVolume": 500,
  "maxDifficulty": 40,
  "demoMode": false
}

Strengthen Weak Rankings

{
  "semrushApiKey": "your_semrush_api_key",
  "yourDomain": "yoursite.com",
  "competitors": ["competitor1.com"],
  "database": "us",
  "gapType": "weak",
  "keywordLimit": 100,
  "demoMode": false
}

High-Volume Opportunities

{
  "semrushApiKey": "your_semrush_api_key",
  "yourDomain": "yoursite.com",
  "competitors": ["competitor1.com", "competitor2.com"],
  "database": "us",
  "gapType": "all",
  "keywordLimit": 150,
  "minVolume": 1000,
  "demoMode": false
}

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

Note: API access requires a SEMrush Business plan or higher.

Input Parameters

Parameter	Type	Default	Description
semrushApiKey	string	-	Your SEMrush API key (required for real data)
yourDomain	string	-	Your domain (e.g., "yoursite.com")
competitors	array	-	Competitor domains (up to 4)
database	string	"us"	Country database (us, uk, de, fr, etc.)
gapType	string	"missing"	Gap type: missing, weak, untapped, strong, all
keywordLimit	number	100	Max keywords to return (max 1000)
minVolume	number	100	Minimum monthly search volume
maxDifficulty	number	70	Maximum keyword difficulty (0-100)
demoMode	boolean	true	Return sample data for testing
webhookUrl	string	-	Webhook URL for results delivery
webhookPlatform	string	"custom"	Platform: zapier, make, n8n, custom

Gap Types Explained

Gap Type	Description
missing	Keywords competitors rank for, you don't rank at all
weak	Keywords where you rank but competitors rank higher
untapped	Keywords only 1 competitor ranks for (less saturated)
strong	Keywords where you outrank competitors (for validation)
all	All gap types combined

Output Format

{
  "yourDomain": "yoursite.com",
  "competitors": ["competitor1.com", "competitor2.com"],
  "database": "us",
  "gapType": "missing",
  "summary": {
    "totalGapKeywords": 847,
    "totalTrafficPotential": 125000,
    "averageDifficulty": 52,
    "averageVolume": 1250,
    "quickWins": 156,
    "highValueKeywords": 89
  },
  "keywords": [
    {
      "keyword": "project management templates",
      "gapType": "missing",
      "volume": 8100,
      "difficulty": 38,
      "cpc": 4.50,
      "trafficPotential": 2430,
      "competitorPositions": {
        "competitor1.com": 3,
        "competitor2.com": 7
      },
      "yourPosition": null,
      "serpFeatures": ["Featured snippet", "Images", "People also ask"],
      "intent": "informational",
      "trend": "rising",
      "priority": "high"
    },
    {
      "keyword": "free task tracker",
      "gapType": "missing",
      "volume": 4400,
      "difficulty": 29,
      "cpc": 2.80,
      "trafficPotential": 1540,
      "competitorPositions": {
        "competitor1.com": 5,
        "competitor2.com": null
      },
      "yourPosition": null,
      "serpFeatures": ["Reviews", "Top stories"],
      "intent": "transactional",
      "trend": "stable",
      "priority": "medium"
    }
  ],
  "topicClusters": [
    {
      "topic": "Project Management",
      "keywords": 45,
      "totalVolume": 89000,
      "averageDifficulty": 48
    },
    {
      "topic": "Task Management",
      "keywords": 32,
      "totalVolume": 52000,
      "averageDifficulty": 41
    }
  ],
  "analyzedAt": "2026-01-28T10:30:00.000Z"
}

Priority Scoring

Priority	Criteria
High	Volume > 3000, Difficulty < 50
Medium	Volume > 1000 OR Difficulty < 40
Low	Lower volume or higher difficulty

Pricing (Pay-Per-Event)

Event	Description	Price
content_gap_analysis	Per gap analysis run	$0.05
keywords_analyzed	Per 100 keywords returned	$0.02

Example costs:

• Gap analysis with 100 keywords: $0.05 + $0.02 = $0.07
• Gap analysis with 500 keywords: $0.05 + (5 × $0.02) = $0.15
• Demo mode: $0.00

Note: You also consume your SEMrush API units (billed separately by SEMrush).

Common Scenarios

Scenario 1: Content Calendar Planning

{
  "semrushApiKey": "your_key",
  "yourDomain": "yoursite.com",
  "competitors": ["competitor1.com", "competitor2.com", "competitor3.com"],
  "database": "us",
  "gapType": "missing",
  "keywordLimit": 300,
  "minVolume": 500,
  "maxDifficulty": 60,
  "webhookUrl": "https://hooks.zapier.com/...",
  "demoMode": false
}

Find achievable content opportunities for quarterly planning.

Scenario 2: Quick Win Identification

{
  "semrushApiKey": "your_key",
  "yourDomain": "yoursite.com",
  "competitors": ["competitor1.com"],
  "database": "us",
  "gapType": "weak",
  "keywordLimit": 100,
  "demoMode": false
}

Find keywords where slight improvements could overtake competitors.

Scenario 3: Niche Expansion Research

{
  "semrushApiKey": "your_key",
  "yourDomain": "yoursite.com",
  "competitors": ["competitor1.com", "competitor2.com"],
  "database": "us",
  "gapType": "untapped",
  "keywordLimit": 200,
  "minVolume": 200,
  "demoMode": false
}

Find less saturated keywords with only one competitor ranking.

Webhook & Automation Integration

Zapier / Make.com / n8n

1. Create a webhook trigger in your automation platform
2. Copy the webhook URL to webhookUrl
3. Set webhookPlatform to your platform
4. Route gap keywords to content tools and calendars

Popular automations:

• High-priority gaps -> Notion content calendar
• New keyword opportunities -> Slack channel
• Weekly gap analysis -> Google Sheets tracker
• Gap keywords -> Airtable content pipeline

Apify Scheduled Runs

Schedule monthly gap analysis to continuously find new opportunities.

SEMrush Content Suite Comparison

Actor	Best For
Content Gap	Finding missing keyword opportunities
Keyword Research	Researching individual keywords
Competitor Analysis	Discovering who competitors are
Position Tracker	Monitoring ranking changes

FAQ

Q: How many competitors should I compare?

A: 2-3 competitors is optimal. More competitors = more data but also more noise. Start with your top 2-3 direct competitors.

Q: What's the difference between "missing" and "weak"?

A: Missing = you don't rank at all. Weak = you rank but lower than competitors. Weak keywords are often faster wins since you have some ranking already.

Q: How is traffic potential calculated?

A: Based on search volume × estimated CTR for the top 3 positions. Higher volume + lower difficulty = higher potential.

Q: What volume threshold should I use?

A: Depends on your site. Established sites: 500+. New sites: 100+. Niche sites may need to go lower.

Q: How do I prioritize which gaps to target?

A: Look at the priority field and sort by trafficPotential. Target high-priority, lower-difficulty keywords first.

Common Problems & Solutions

"Invalid API key" error

• Verify your API key from SEMrush dashboard
• Ensure your plan includes API access (Business+)
• Check for extra spaces when copying the key

"Rate limit exceeded" error

• Wait a few minutes and retry
• Reduce keywordLimit
• Check your SEMrush API unit usage

"No gap keywords found"

• You may already rank well against these competitors
• Try different competitors
• Lower the minVolume threshold
• Raise the maxDifficulty threshold

"Too many keywords returned"

• Increase minVolume to focus on higher-value keywords
• Lower maxDifficulty to focus on achievable keywords
• Use gapType: "missing" instead of "all"

"Demo data showing"

• Set demoMode: false
• Provide a valid semrushApiKey

---

📞 Support

• Actor Arsenal: Full Actor Catalog
• Developer: John Rippy

---

Built by John Rippy | Actor Arsenal