Competitor Analysis

Competitor Analysis descompone un dominio de la competencia en dos niveles: qué posicionan ellos que tú no posicionas (content-gaps), y en qué topic-clusters son fuertes y en cuáles débiles. Obtienes una lista priorizada de gaps con volumen de búsqueda, difficulty y un opportunity-score, además de un mapa de topic-cluster que muestra dónde la competencia construye autoridad temática. Es el puente entre el simple keyword-pull (Keyword Explorer & Research) y la planificación estratégica de contenido — no solo ves keywords, sino dónde tu universo temático tiene huecos.

Qué puede hacer

• Domain-Deep-Scan — pull completo de visibilidad por dominio competidor incluyendo top URLs que posicionan.
• Detección de content-gaps — keywords en las que la competencia posiciona y tú no.
• Opportunity-Score — ranking ponderado de Volume × Difficulty × posición de la competencia.
• Topic-Cluster-Mapping — los gaps se agrupan en temas, no se sirven como lista plana de keywords.
• Filtros — acota gaps por topic-cluster, score mínimo, volumen mínimo.
• Re-Rank — reevalúa competidores dentro de un análisis sin nuevo pull.
• Pipeline async — el pull corre como Queue-Job, dominios grandes tardan varios minutos.

Cuándo usarlo

• Planeas una estrategia de contenido y quieres saber dónde la competencia te adelanta.
• Necesitas una lista priorizada de nuevos temas de artículo con potencial de tráfico demostrado.
• Quieres derivar topic-clusters para tus Storylines de datos SERP reales.
• Empiezas en un nicho nuevo y necesitas un mapa de la competencia.

Workflow

1. Inicia el análisis — POST /competitor-analyses con {project_id, domain}. Respuesta 202.
2. El pull corre en background — DataForSEO + motor interno de clustering, según el tamaño del dominio tarda 2–10 minutos.
3. Lee el detalle — GET /competitor-analyses/{id} muestra resumen + top-clusters.
4. Drilldown por gaps — GET /competitor-analyses/{id}/gaps con ?topic_cluster= y ?min_score= para filtrar.
5. Re-Rank opcional — POST /competitor-analyses/{id}/rerank-competitors si quieres ajustar ponderaciones.
6. Sigue — expande las top-gap-keywords en el Keyword Explorer & Research o pásalas como briefings al AI Content Editor.

API

Ejemplo de body POST /competitor-analyses:

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

Créditos y límites

• Inicio: 20 créditos por análisis run.
• El pull es async — 202 directo, resultado por polling.
• Re-Rank no consume créditos (recálculo interno).
• Dominios muy grandes (sites enterprise) se cappean a las top-N keywords — el cap depende del plan.

Módulos relacionados

• Content Audit — confronta el inventario propio del site contra la lista de gaps.
• Keyword Explorer — comprueba volumen / KD de las gap-keywords y exíndelas.
• Storylines — condensa los topic-clusters en planes de contenido estructurados.
• Rank Tracker — observa nuevas keywords tras la publicación.