# SISTRIX Best Practices Guide 2026

**Last Updated:** 2026-04-02  
**Purpose:** Comprehensive best practices for using SISTRIX API for SEO content writing and optimization

## Overview

This guide documents best practices for leveraging SISTRIX API data to create the best content possible. It covers data collection strategies, content optimization techniques, and workflow integration.

## Data Collection Best Practices

### 1. Keyword Research Strategy

**Primary Keywords:**
- Extract from post slug (most SEO-relevant)
- Extract from title (2-3 word phrases)
- Extract from meta keywords if available
- Limit to 5-7 most relevant keywords per post

**Related Keywords:**
- Use `marketplace.keyword.search.ideas` endpoint
- Collect 10-15 semantic variations per primary keyword
- Prioritize by traffic and competition
- Use for internal linking and content expansion

**Historical Trends:**
- Include `history=true` parameter in keyword metrics
- Track volume and competition changes over time
- Identify seasonal patterns
- Use trend direction (rising/declining/stable) for prioritization

### 2. PAA Questions Collection

**Best Practices:**
- Use `keyword.questions` endpoint (not SERP features for actual questions)
- Collect top 10-15 questions per primary keyword
- Prioritize by search volume and frequency
- Use questions directly as FAQ items
- Target featured snippets with concise answers (40-60 words)

**Integration:**
- Store in `paa-questions.json` with priority scores
- Use for FAQ generation and content optimization
- Update quarterly (questions change slowly)

### 3. Competitor Analysis

**Collection Strategy:**
- Use `keyword.seo` endpoint to get top 10 ranking URLs
- Analyze top 3-5 competitors (skip own domain)
- Extract content structure (headings, word count, FAQs)
- Store competitor insights for content planning

**Analysis Focus:**
- Word count (target: exceed average by 20% or match maximum)
- Heading structure (use competitor headings as recommendations)
- FAQ coverage (address competitor FAQs in your content)
- Content depth (match or exceed competitor comprehensiveness)

### 4. Credit Management

**Weekly Limit (Primary Constraint):**
- 10,000 credits per week (resets Monday)
- Monitor weekly usage closely
- Prioritize high-value collections

**Daily Limit (Secondary Constraint):**
- 2,000 credits per day (relaxed if weekly credits available)
- Can exceed daily limit if weekly credits remain (>5,000)

**Optimization Strategies:**
- Use batch mode for keyword collection (10 keywords per call)
- Leverage caching (30 days for stable data, 7 days for dynamic)
- Collect domain-level data once, reuse for all posts
- On **scale-tier** surfaces (blog at volume, bulk tools): avoid wide use of expensive **`keyword.domain.seo` + `kw`** (~100 credits/keyword SERP-style pulls); prefer **`keyword.seo`** and batch metrics first
- Use `--dry-run` to estimate credit usage

### Blog vs VIP marketing surfaces

- **Blog and long-tail tools:** Stay credit-conscious; expensive domain-keyword SERP is for narrow, justified cases (see [blog-data-collection.mdc](../../.cursor/rules/blog-data-collection.mdc)).
- **VIP marketing URLs** (registry product features, Branchen, static Tier A such as homepage and pricing): **Selective** `keyword.domain.seo` + `kw` for **1–5 head terms** per sprint is **in policy** when decisions require it, with mandatory synthesis + `KEYWORD_DECISION.md` follow-through — [VIP_MARKETING_SEO_DATA_TIERS.md](pages/marketing-pages/VIP_MARKETING_SEO_DATA_TIERS.md).

## Content Optimization Best Practices

### 1. Content Depth Optimization

**Based on Competitor Analysis:**
- Calculate average competitor word count
- Target: Exceed average by 20% or match maximum
- Use competitor analysis to determine optimal depth

**Based on Competition Level:**
- Low competition (< 30): 1,500+ words
- Medium competition (30-60): 1,500-2,500 words
- High competition (> 60): 2,500+ words

### 2. FAQ Optimization

**PAA Questions Integration:**
- Use specific PAA questions (not generic suggestions)
- Prioritize by search volume
- Provide comprehensive answers (40-60 words)
- Add FAQ schema markup
- Place FAQ section after main content

**Competitor FAQ Analysis:**
- Review competitor FAQs
- Address gaps in your content
- Provide better, more comprehensive answers
- Add competitor FAQs as additional FAQ items if not covered

### 3. Content Structure Optimization

**Headings from Competitors:**
- Extract headings from top 3-5 competitors
- Identify frequently used headings (appear in multiple competitors)
- Use as recommendations for content structure
- Ensure logical hierarchy (H2 → H3)

**Content Sections:**
- Introduction (100-200 words) - Include primary keyword
- Main sections (based on competitor headings)
- FAQ section (5-10 FAQs from PAA questions)
- Conclusion (50-100 words) - Key takeaways

### 4. Keyword Integration

**Primary Keyword:**
- Include in title tag
- Include in H1 (page title)
- Include in first paragraph
- Natural density: 1-2% throughout content

**Secondary Keywords:**
- Integrate naturally throughout content
- Use in subheadings where appropriate
- Maintain natural language flow

**Related Keywords:**
- Use for internal linking opportunities
- Expand content to cover related topics
- Create keyword clusters for topical authority

### 5. Internal Linking Strategy

**Based on Related Keywords:**
- Identify related keywords with traffic potential
- Create internal links to relevant existing content
- Use descriptive anchor text
- Target 10-15 internal links per post

**Keyword Clusters:**
- Map keyword clusters from topical authority analysis
- Link between cluster content
- Build pillar pages with supporting cluster articles

## Workflow Integration

### 1. Content Creation Workflow

**Step 1: Data Collection**
```bash
# Use Content Writing Assistant for full workflow
php v2/scripts/content/content-writing-assistant.php --post=slug --category=category --mode=full
```

**Step 2: Review Content Brief**
- Review generated content brief
- Check PAA questions
- Review competitor analysis
- Note recommended headings and word count

**Step 3: Write Content**
- Follow content brief structure
- Use recommended headings
- Address PAA questions in FAQs
- Meet target word count

**Step 4: Optimize Content**
- Run optimization suggestions
- Score content quality
- Address optimization recommendations
- Verify keyword integration

### 2. Content Update Workflow

**Step 1: Generate Suggestions**
```bash
php v2/scripts/content/integrate-sistrix-insights.php --post=slug --category=category
```

**Step 2: Review Recommendations**
- Check specific PAA questions to add
- Review competitor insights
- Identify content gaps
- Prioritize optimizations

**Step 3: Implement Optimizations**
- Add missing FAQs
- Expand content depth
- Improve internal linking
- Optimize headings

**Step 4: Score Quality**
- Run content quality scoring
- Verify improvements
- Track optimization impact

## Advanced Techniques

### 1. Topical Authority Building

**Keyword Clustering:**
- Use `analyze-topical-authority.php` to identify clusters
- Map content gaps in clusters
- Create pillar pages for main topics
- Build supporting cluster articles

**Content Gaps:**
- Identify topics with no content
- Prioritize by potential traffic
- Create comprehensive pillar pages
- Link cluster content together

### 2. Historical Trend Analysis

**Seasonal Patterns:**
- Track search volume trends over time
- Identify seasonal keywords
- Plan content updates for peak seasons
- Adjust content strategy based on trends

**Competition Changes:**
- Monitor competition level changes
- Adjust content depth strategy
- Update optimization priorities
- Track ranking improvements

### 3. Competitive Content Analysis

**Content Structure:**
- Analyze competitor headings
- Identify common content patterns
- Extract competitor FAQs
- Determine optimal content depth

**Gap Analysis:**
- Compare your content to competitors
- Identify missing sections
- Find FAQ opportunities
- Discover internal linking gaps

## Quality Scoring

### Content Quality Metrics

**Keyword Optimization (30%):**
- Primary keyword in title: 25 points
- Primary keyword in first paragraph: 25 points
- Primary keyword density: 50 points

**Content Depth (30%):**
- Based on competitor analysis
- Exceeds average by 20%: 100 points
- Matches average: 75 points
- Below average: 25-50 points

**FAQ Coverage (20%):**
- Addresses PAA questions
- Coverage percentage determines score

**Internal Linking (20%):**
- 15+ links: 100 points
- 10-14 links: 75 points
- 5-9 links: 50 points
- <5 links: 25 points

**Overall Score:**
- 80-100: Excellent
- 60-79: Good (some improvements recommended)
- <60: Needs improvement

## Common Pitfalls to Avoid

1. **Over-reliance on High-Volume Keywords**
   - Consider competition and intent
   - Focus on achievable keywords
   - Balance volume with competition

2. **Ignoring PAA Questions**
   - PAA questions are high-value opportunities
   - Use actual questions, not just detection
   - Prioritize by search volume

3. **Generic Recommendations**
   - Use specific recommendations from competitor analysis
   - Provide exact headings, FAQs, word counts
   - Avoid generic "add FAQs" suggestions

4. **Not Using Related Keywords**
   - Related keywords expand topical coverage
   - Use for internal linking
   - Build keyword clusters

5. **Ignoring Competitor Analysis**
   - Competitor analysis provides specific targets
   - Use for content structure planning
   - Identify content gaps

## Performance Optimization

### Caching Strategy

**30-Day Cache (Stable Data):**
- Keyword metrics (with historical trends)
- Related keywords
- PAA questions
- Search intent

**7-Day Cache (Dynamic Data):**
- SERP features
- Competitor rankings
- Domain opportunities

**24-Hour Cache (Very Dynamic):**
- Traffic estimates
- Ranking positions

### Batch Processing

**Keyword Collection:**
- Process in batches of 10 keywords
- Reduces API calls by 90%
- More efficient credit usage

**Competitor Analysis:**
- Analyze top 5 competitors per keyword
- Batch competitor URL collection
- Parallel content analysis where possible

### Credit Optimization

**Prioritization:**
- High-volume keywords first
- Low-competition keywords prioritized
- PAA questions for top keywords
- Competitor analysis for primary keywords only

**Efficiency:**
- Use batch mode always
- Check cache before API calls
- Skip expensive endpoints when possible
- Monitor credit usage continuously

## Monitoring and Maintenance

### Regular Checks

**Weekly:**
- Review credit usage reports
- Check cache efficiency
- Monitor data freshness
- Review content quality scores

**Monthly:**
- Update PAA questions (if needed)
- Refresh competitor analysis
- Update historical trends
- Review topical authority analysis

**Quarterly:**
- Full data refresh for top-performing posts
- Review keyword clusters
- Update content gaps
- Optimize credit usage patterns

## Related Documentation

- `docs/content/SISTRIX_CONTENT_INTEGRATION_GUIDE.md` - Integration guide
- `docs/content/CONTENT_CREATION_WORKFLOW_2026.md` - Content creation workflow
- `docs/content/CONTENT_UPDATE_WORKFLOW_2026.md` - Content update workflow
- `.cursor/rules/blog-data-collection.mdc` - Data collection rules
- `docs/content/SISTRIX_PAA_RESEARCH_FINDINGS.md` - PAA extraction research