202 lines
7.9 KiB
Markdown
202 lines
7.9 KiB
Markdown
# ✅ SIMPLIFIED FLOW - Informational Keywords Only
|
||
|
||
## 🎯 What Changed
|
||
|
||
### 1. **Fixed Domain Format** (Critical!)
|
||
**Before (WRONG):**
|
||
```
|
||
*|or|competitor1|+|or|competitor2|-|or|client
|
||
```
|
||
|
||
**After (CORRECT per [SEMrush Tutorial](https://developer.semrush.com/api/basics/api-tutorials/analytics-api/#analyze-keyword-gaps-among-competitors/)):**
|
||
```
|
||
-|or|client|+|or|competitor1|+|or|competitor2
|
||
```
|
||
|
||
### 2. **Removed Unnecessary Complexity**
|
||
- ❌ Removed "At Least One Competitor" tab
|
||
- ❌ Removed "All Competitors Have" tab
|
||
- ✅ **Just show: Informational Gap Keywords (Intent=1)**
|
||
|
||
### 3. **Added phrase_this Validation**
|
||
- ✅ Checkbox enabled by default
|
||
- ✅ Each keyword hits: `https://api.semrush.com/?type=phrase_this&phrase=KEYWORD&export_columns=In`
|
||
- ✅ Cost: 10 units per keyword
|
||
- ✅ Shows in Network tab
|
||
|
||
### 4. **Simplified Output**
|
||
- ✅ Domain Metrics (kept)
|
||
- ✅ Informational Gap Keywords only
|
||
- ✅ API Usage Report with phrase_this breakdown
|
||
- ❌ No complex tabs or multiple views
|
||
|
||
---
|
||
|
||
## 🔄 Complete Flow (Simplified)
|
||
|
||
```
|
||
USER FILLS FORM
|
||
├─ Client: evendigit.com
|
||
├─ Competitor 1: infidigit.com
|
||
├─ Competitor 2: ignitevisibility.com
|
||
├─ Display Limit: 100
|
||
└─ ✅ Validate with phrase_this (checked)
|
||
↓
|
||
┌──────────────────────────────────────────────┐
|
||
│ STEP 1: domain_domains API Call │
|
||
└──────────────────────────────────────────────┘
|
||
GET /api/semrush/?type=domain_domains
|
||
&domains=-|or|evendigit.com|+|or|infidigit.com|+|or|ignitevisibility.com
|
||
&display_limit=100
|
||
&export_columns=Ph,P0,P1,P2,In,Nq,Kd,Co,Cp
|
||
|
||
Response: 68 keywords (all intents)
|
||
Cost: 680 units
|
||
↓
|
||
┌──────────────────────────────────────────────┐
|
||
│ STEP 2: phrase_this API Validation │
|
||
│ (EACH keyword validated) │
|
||
└──────────────────────────────────────────────┘
|
||
For EACH of the 68 keywords:
|
||
|
||
1. GET /api/semrush/?type=phrase_this&phrase=seo+tips&export_columns=In
|
||
Response: Intent=1 → ✅ KEEP
|
||
|
||
2. GET /api/semrush/?type=phrase_this&phrase=buy+seo+tools&export_columns=In
|
||
Response: Intent=3 → ❌ REMOVE
|
||
|
||
3. GET /api/semrush/?type=phrase_this&phrase=seo+guide&export_columns=In
|
||
Response: Intent=1 → ✅ KEEP
|
||
|
||
... (65 more API calls)
|
||
|
||
Total phrase_this calls: 68
|
||
Cost: 68 × 10 = 680 units
|
||
Result: 46 keywords with Intent=1
|
||
↓
|
||
┌──────────────────────────────────────────────┐
|
||
│ STEP 3: Fetch Domain Metrics │
|
||
└──────────────────────────────────────────────┘
|
||
Parallel calls for 3 domains:
|
||
- domain_ranks (3 calls × 10 = 30 units)
|
||
- backlinks_overview (3 calls × 10 = 30 units)
|
||
- backlinks_refdomains (3 calls × 100 = 300 units)
|
||
|
||
Cost: 360 units
|
||
↓
|
||
┌──────────────────────────────────────────────┐
|
||
│ STEP 4: Display Results │
|
||
└──────────────────────────────────────────────┘
|
||
📊 API Usage Report
|
||
├─ Total Units: 1,720
|
||
├─ Cost: $0.086
|
||
└─ phrase_this: 68 calls, 680 units
|
||
|
||
🎯 Informational Gap Keywords: 46
|
||
├─ Keywords competitors have, client doesn't
|
||
└─ All verified as Intent=1 (Informational)
|
||
|
||
📍 Domain Metrics (3 domains)
|
||
├─ Client: evendigit.com
|
||
│ ├─ Authority Score: 29
|
||
│ ├─ Organic Traffic: 73
|
||
│ └─ Organic Keywords: 641
|
||
├─ Competitor 1: infidigit.com
|
||
└─ Competitor 2: ignitevisibility.com
|
||
```
|
||
|
||
---
|
||
|
||
## 🧪 Console Output Example
|
||
|
||
When you run with `validateWithPhrasethis=true`, you'll see:
|
||
|
||
```bash
|
||
══════════════════════════════════════════════════════════
|
||
🔍 PHRASE_THIS API VALIDATION - Intent Verification
|
||
══════════════════════════════════════════════════════════
|
||
📊 Keywords to validate: 68
|
||
💰 Cost: 68 keywords × 10 units = 680 units
|
||
💵 Estimated: $0.0340
|
||
🔍 API: https://api.semrush.com/?type=phrase_this&phrase=KEYWORD&export_columns=In
|
||
══════════════════════════════════════════════════════════
|
||
|
||
[BATCH 1/7] Validating keywords 1-10...
|
||
1. "seo tips" (Volume: 5400)
|
||
2. "seo guide" (Volume: 3200)
|
||
3. "content marketing" (Volume: 2100)
|
||
...
|
||
|
||
[API CALL] phrase_this for "seo tips"
|
||
URL: /api/semrush/?type=phrase_this&phrase=seo+tips&database=us&export_columns=In&key=***
|
||
Cost: 10 units
|
||
Response: Intent = 1
|
||
[RESULT] "seo tips" - Intent: Informational (1) ✅ INFORMATIONAL
|
||
|
||
✅ "seo tips" → Intent=1 (Informational) - KEPT
|
||
❌ "buy seo tools" → Intent=3 (Transactional) - FILTERED OUT
|
||
✅ "seo guide" → Intent=1 (Informational) - KEPT
|
||
|
||
[BATCH 1] ✅ Complete: 7/10 keywords are Informational
|
||
|
||
... (batches 2-7)
|
||
|
||
══════════════════════════════════════════════════════════
|
||
📊 VALIDATION COMPLETE
|
||
══════════════════════════════════════════════════════════
|
||
📥 Keywords received: 68
|
||
🔍 API calls made: 68
|
||
✅ Keywords validated (Intent=1): 46
|
||
❌ Keywords filtered out: 22
|
||
💰 Total units consumed: 680 units
|
||
💵 Total cost: $0.0340
|
||
══════════════════════════════════════════════════════════
|
||
```
|
||
|
||
---
|
||
|
||
## 🌐 Network Tab - You'll See
|
||
|
||
```
|
||
Name Status Type Size
|
||
─────────────────────────────────────────────────────────────────
|
||
domain_domains?key=...&domains=-|or|... 200 xhr 2.1kB
|
||
phrase_this?phrase=seo+tips&... 200 xhr 15B
|
||
phrase_this?phrase=buy+seo+tools&... 200 xhr 15B
|
||
phrase_this?phrase=seo+guide&... 200 xhr 15B
|
||
phrase_this?phrase=content+marketing&... 200 xhr 15B
|
||
... (64 more phrase_this calls)
|
||
domain_ranks?domain=evendigit.com&... 200 xhr 156B
|
||
domain_ranks?domain=infidigit.com&... 200 xhr 156B
|
||
domain_ranks?domain=ignitevisibility.com&... 200 xhr 156B
|
||
backlinks_overview?target=evendigit.com&... 200 xhr 245B
|
||
... (more backlink calls)
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ What You Get
|
||
|
||
1. **API Usage Report** - Shows total units, cost, and phrase_this breakdown
|
||
2. **Informational Gap Keywords** - ONLY Intent=1 keywords (simplified!)
|
||
3. **Domain Metrics** - Authority Score, Traffic, Keywords, Backlinks
|
||
4. **No unnecessary tabs** - Clean, single view
|
||
|
||
---
|
||
|
||
## 🚀 Ready to Test!
|
||
|
||
1. **Refresh browser** (Cmd+Shift+R)
|
||
2. **Fill form:**
|
||
- Client: `evendigit.com`
|
||
- Competitor 1: `infidigit.com`
|
||
- Competitor 2: `ignitevisibility.com`
|
||
- Display Limit: `100`
|
||
- ✅ **Validate with phrase_this** (checked by default)
|
||
3. **Open Network tab**
|
||
4. **Click "Run Unified Analysis"**
|
||
5. **Watch phrase_this calls appear!** 🎉
|
||
|
||
Each keyword will hit the phrase_this API and you'll see it in the Network tab!
|
||
|