SEO Schema Validator & JSON-LD Health Check

Crawl entire sitemaps to validate structured data (JSON-LD) and meta tags. Detect broken schema, missing required fields, and generating a white-label ready SEO health report.

Targeted Keywords

• Primary: Schema Markup Validator, JSON-LD Validator, Bulk Structured Data Testing Tool, Technical SEO Audit Tool, Rich Snippet Checker
• Secondary: Validate Sitemap Schema, Broken JSON-LD Finder, Google Rich Results Bulk Check, SEO Health Report Generator, Automated Schema Audit

Automate Your Technical SEO Audits

Manually checking structured data on hundreds of pages is impossible. The SEO Schema Validator crawls your target sitemap, extracts all JSON-LD schema markup, and validates it against Schema.org standards and Google's Rich Result requirements.

Why use this Actor?

• Bulk Validation: Don't check one URL at a time. Input a sitemap and validate 1,000+ pages in minutes.
• Rich Result Eligibility: Instantly spot pages missing critical keys (e.g., missing aggregateRating in Product schema or datePublished in Article schema).
• Syntax Error Detection: Identify broken JSON, unclosed brackets, or invalid types that break your SEO.
• Agency-Ready Reporting: The output is structured as a clean JSON/CSV dataset, ready to be converted into client reports or dashboards.

Key Features

✅ Validates deeply nested JSON-LD objects.

✅ Checks for presence of critical Meta Tags (Title, Description, Robots).

✅ Detects "silent" errors that don't break the page but do break the snippet.

✅ Returns a "Health Score" for every URL.

Input

Field	Type	Description	Default
sitemap_url	String	The URL of the sitemap to crawl.	Required
start_urls	Array	Fallback list of URLs if no sitemap is provided.	Optional
smart_sampling	Boolean	Enable pattern-based sampling for large sites.	true
max_pages	Integer	Maximum number of pages to check.	1000

💡 How to Find a Website's Sitemap

Most websites have a sitemap at one of these common locations:

1. The Standard Path: Check yourdomain.com/sitemap.xml.
2. Robots.txt: Visit yourdomain.com/robots.txt. Most sites list their sitemap URL(s) there.
3. Sitemap Index: Large sites often use an index, like yourdomain.com/sitemap_index.xml.
4. Common Platforms:
   • WordPress: Typically /sitemap.xml, /sitemap_index.xml, or /wp-sitemap.xml.
   • Shopify: Usually /sitemap.xml.
   • Squarespace: Usually /sitemap.xml.

If you still can't find it, try searching Google for site:yourdomain.com filetype:xml sitemap.

Input Example

{
  "sitemap_url": "https://apify.com/sitemap.xml",
  "smart_sampling": true,
  "max_pages": 1000
}

Output

The actor stores results in the default dataset. Each item represents a page and includes:

{
  "url": "https://example.com/product/123",
  "health_score": 85,
  "issues": [
    {
      "severity": "CRITICAL",
      "message": "Product schema missing 'name'.",
      "context": "..."
    }
  ],
  "meta": {
    "title": "Product Name",
    "description": "Great product description.",
    "canonical": "https://example.com/product/123",
    "og_image": "https://example.com/img.jpg"
  },
  "schemas_found": 1
}

Health Score Calculation

The actor computes a per-page health_score as an integer in the range 0–100. The calculation is designed to highlight critical structural issues first.

Rules:

• Start at 100 points.
• For each CRITICAL issue subtract 20 points.
• For each WARNING issue subtract 5 points.
• INFO issues do not deduct points.
• The score is clamped to a minimum of 0.

Common CRITICAL issues (deduct 20 points):

• Missing <title> tag.
• Invalid JSON-LD syntax (broken code).
• Schema missing @context or @type.
• Missing required schema properties (e.g., Product without name).

Common WARNING issues (deduct 5 points):

• Missing meta description.
• Schema @context value that does not reference schema.org.
• Missing canonical link element.

How to use the output

The results are saved in the "Dataset" tab of your run. You can:

1. Export the data to CSV, JSON, or Excel.
2. Filter by health_score to find the worst-performing pages first.
3. Share the report with your team or clients to fix the issues.

FAQ

• Q: Does this actor submit data to Google or other services?
  • A: No. It only reads pages and writes validation reports to your dataset.
• Q: Will the actor change or write to my site?
  • A: No. The actor performs read-only checks.
• Q: Can I run this actor on a schedule?
  • A: Yes — use Apify platform scheduling features to run this audit regularly (e.g., weekly).

Support & Feedback

If you find bugs or want to request features, please open an issue in the project repository.