Competitor Analysis

Competitor Analysis breaks down a competitor domain on two levels: what they rank for that you don't (content gaps), and which topic clusters they're strong or weak in. You get a prioritized gap list with search volume, difficulty, and an opportunity score, plus a topic-cluster map showing where the competition is building topical authority. It's the bridge between raw keyword pulls (Keyword Explorer & Research) and strategic content planning — you see not just keywords, but where your topic universe has holes.

What it can do

• Domain deep scan — full visibility pull per competitor domain, including top-ranking URLs.
• Content-gap detection — keywords the competitor ranks for and you don't.
• Opportunity score — weighted ranking from volume × difficulty × competitor position.
• Topic-cluster mapping — gaps are bundled into themes, not served as a flat keyword list.
• Filters — narrow gaps by topic cluster, minimum score, minimum volume.
• Re-rank — re-weight competitors within an analysis without a new pull.
• Async pipeline — the pull runs as a queue job; large domains take several minutes.

When to use

• You're planning a content strategy and want to know where the competition outranks you.
• You need a prioritized list of new article topics with proven traffic potential.
• You want to derive topic clusters for your Storylines from real SERP data.
• You're entering a new niche and need a map of the competitive landscape.

Workflow

1. Start analysis — POST /competitor-analyses with {project_id, domain}. Returns 202.
2. Pull runs in background — DataForSEO + internal cluster engine, takes 2–10 minutes depending on domain size.
3. Read detail — GET /competitor-analyses/{id} shows overview + top clusters.
4. Drill into gaps — GET /competitor-analyses/{id}/gaps filtered with ?topic_cluster= and ?min_score=.
5. Re-rank optional — POST /competitor-analyses/{id}/rerank-competitors if you want to adjust the weighting.
6. Follow up — expand top-gap keywords in Keyword Explorer & Research or send them straight as briefs to AI Content Editor.

API

Body example POST /competitor-analyses:

{
  "project_id": 42,
  "domain": "konkurrenz-domain.de"
}

Credits & Limits

• Start: 20 credits per analysis run.
• The pull is async — 202 immediately, result via polling.
• Re-rank is credit-free (purely an internal recalculation).
• Very large domains (enterprise sites) are capped at the top-N keywords — the cap is plan-dependent.

Related modules

• Content Audit — match your own site inventory against the gap list.
• Keyword Explorer — check found gap keywords on volume / KD and expand.
• Storylines — condense topic clusters into structured content plans.
• Rank Tracker — watch new keywords after publishing.