# @spy Research Brief: Documentation SEO Analysis

**Date:** January 2, 2026
**Priority:** Medium
**Requested by:** @men (strategy session)
**Budget limit:** $0.50 DataForSEO

---

## Context

We've launched documentation section at `banatie.app/docs/` with 10 pages. SEO metadata and JSON-LD schemas are implemented. Now we need competitive intelligence to identify potential improvements.

**Constraint:** No major content changes — this is technical documentation. Looking for small optimizations and gaps we might be missing.

---

### Task 0: Free search and analysis of existing documentation section

**Goal:** Inspect real NextJS pages for potential content improvements and to be aware of what exact content we have in docs section

Browse docs section in landing app project (NextJS) using Filesystem MCP:

`/projects/my-projects/banatie-service/apps/landing/src/app/(apps)/docs`

Understand the content. Collect the list of potential topics and keywords we can consider to promote via SEO

---

## Research Tasks

### Task 1: Keyword Opportunities

**Goal:** Find keywords developers use when searching for image generation API documentation.

**DataForSEO queries:**

```
Seeds to research:
- "image generation api"
- "ai image api documentation"
- "text to image api tutorial"
- "generate image from prompt api"
```

**What to find:**
1. Related keywords with Volume > 50, KD < 40
2. Long-tail variations we might target
3. Question-based keywords ("how to generate image with api")

**Output format:**
```
| Keyword | Volume | KD | Intent | Opportunity |
|---------|--------|-----|--------|-------------|
```

---

### Task 2: Competitor Documentation Structure

**Goal:** Understand what sections competitors have that we might be missing.

**Targets to analyze:**
1. `docs.replicate.com` — market leader in AI model APIs
2. `fal.ai/docs` — direct competitor, similar positioning
3. `docs.runware.ai` — budget competitor
4. `cloudinary.com/documentation` — gold standard for image APIs

**What to check:**
- Main navigation structure (what sections exist)
- Do they have interactive elements? (playgrounds, live code)
- Do they have SDK/CLI docs? (we don't yet but plan to)
- Any unique sections we don't have?

**Output format:**
```
## [Competitor Name]

**URL:** ...
**Main sections:**
- Section 1
- Section 2
...

**Unique elements:**
- ...

**What we could adopt:**
- ...
```

---

### Task 3: SERP Analysis

**Goal:** Understand what type of content ranks for our target queries.

**Queries to check:**
1. "image generation api"




## Deliverables

Create file: `/banatie-content/research/keywords/docs-seo-analysis-2026-01-02.md`

Structure:
```
## Deliverables

Create file: `/banatie-content/research/keywords/docs-seo-analysis-2026-01-02.md`

Structure:
```
2. "ai image api documentation"
3. "text to image rest api"
4. "generate image from text api"

**What to note:**
- Who ranks in top 10?
- What content type? (landing page, docs, tutorial, blog post)
- Any featured snippets? What format?
- Do any competitors appear?

**Output format:**
```
## Query: "[keyword]"

**Top 3 results:**
1. [URL] — [Type: landing/docs/blog] — [Brief description]
2. ...
3. ...

**Featured snippet:** Yes/No — [Format if yes]
**Our competitors present:** [List]
```

---

### Task 4: Content Gap Analysis (Optional if budget allows)

**Goal:** Find keywords competitors rank for that we don't cover.

**Method:** Use DataForSEO `domain_intersection` or `ranked_keywords` for:
- replicate.com/docs
- fal.ai/docs

Filter for keywords with:
- Volume > 100
- Related to image generation
- We have no content for

---



## Deliverables

Create file: `/banatie-content/research/keywords/docs-seo-analysis-2026-01-02.md`

Structure:
```markdown
# Documentation SEO Analysis

**Date:** January 2, 2026
**Research by:** @spy

## Executive Summary
[2-3 key findings]

## 1. Keyword Opportunities
[Task 1 results]

## 2. Competitor Structure Analysis
[Task 2 results]

## 3. SERP Analysis
[Task 3 results]

## 4. Content Gaps (if completed)
[Task 4 results]

## Recommendations
[Prioritized list of actionable improvements]

## Strategic Signals
[Anything that should go to banatie-strategy/inbox/]
```

---

## Notes for @spy

- Focus on actionable insights, not comprehensive data dumps
- If something is strategically important (funding, major competitor move), create separate file in `banatie-strategy/inbox/`
- Budget is limited — prioritize Tasks 1-3, Task 4 only if budget remains
- We're NOT changing our documentation structure significantly — looking for small wins

---

## Success Criteria

Good research will answer:
1. Are there keywords with decent volume that we should add to our pages?
2. Are competitors doing something in their docs that we should consider?
3. What content type does Google prefer for these queries?
4. Any quick wins we can implement this week?

---

**End of Brief**
