jassim/Keyword-research-analysis
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
Keyword-research-analysis/SIMPLIFIED_FLOW.md
jassim 94b41532c7 ui changes
2025-11-05 11:57:23 +05:30

6.3 KiB
Raw Permalink Blame History

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]

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