Overview

Understand how your structured data compares to competitors. Submit competitor URLs and ValidGraph analyzes their schema markup, comparing types, properties, and completeness scores against yours.

How It Works

1. User submits their URL and one or more competitor URLs
2. ValidGraph validates all URLs
3. A comparison report is generated showing:
– Schema types used by competitors but missing from your site
– Property coverage differences
– Score comparison
– Opportunities for improvement

Tier Availability

| Tier | Available |
|——|———–|
| Free | No |
| Pro | Yes |
| Agency | Yes |
| Enterprise | Yes |

Related Features

– Schema Completeness Score: Scoring used for comparison
– Site-Wide Score: Broader competitive positioning

Mini-Tutorial

Step 1: Gather URLs

Identify your website and at least one competitor to compare. Have these URLs ready.

Step 2: Submit Comparison

POST /api/v1/analyze-competitor
{
  "own_url": "https://mysite.com",
  "competitor_urls": ["https://competitor1.com", "https://competitor2.com"]
}

Step 3: Review Results

The API returns a detailed comparison showing:
– Schema types each site uses
– Property coverage gaps in your markup
– Completeness scores side-by-side
– Specific recommendations to match or exceed competitors

Step 4: Act on Insights

Use the recommendations to add missing schema types or properties to your site, then re-validate to track improvement.

Technical Details

Request Format

{
  "own_url": "https://example.com",
  "competitor_urls": ["https://competitor-a.com", "https://competitor-b.com"]
}

Response Example

{
  "comparison": {
    "own_score": 78,
    "competitor_scores": {
      "https://competitor-a.com": 85,
      "https://competitor-b.com": 72
    },
    "your_types": ["Article", "Organization", "BreadcrumbList"],
    "their_types_you_lack": ["Product", "Review"],
    "your_property_coverage": 0.82,
    "their_avg_coverage": 0.88,
    "gaps": [
      {
        "property": "aggregateRating",
        "recommended_for": "Product",
        "coverage_impact": 0.12
      }
    ],
    "opportunities": [
      "Add Product schema to e-commerce pages",
      "Implement Review schema for testimonials",
      "Include aggregateRating in your markup"
    ]
  }
}

Error Handling

– 404: One or more competitor URLs returned 404 errors during crawl
– 422: URL format invalid or unable to resolve
– 429: Rate limit exceeded; retry after delay

References

– Schema.org Main Vocabulary
– Google Rich Results Guide
– JSON-LD Format Specification
– W3C Structured Data Best Practices