Keyword-research-analysis/SIMPLIFIED_FLOW.md

✅ 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):

-|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:

══════════════════════════════════════════════════════════
🔍 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!