# 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]

     [KEPT] "seo tips" → Intent=1 (Informational)
     [FILTERED] "buy seo tools" → Intent=3 (Transactional)
     [KEPT] "seo guide" → Intent=1 (Informational)

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