JSON-LD Schema Auditor

Fetches one public web page and audits its JSON-LD structured data. It reports script counts, parse errors, detected schema types, missing @type values, and a simple readiness score.

Use cases

• Check structured data during SEO launches and migrations.
• Monitor important landing pages for broken JSON-LD.
• Feed schema-readiness results into SEO QA dashboards.
• Verify that pages expose common schema types such as Organization, WebSite, Article, Product, BreadcrumbList, FAQPage, or LocalBusiness.

Input

Field	Type	Required	Description
startUrl	string	Yes	Public HTTP or HTTPS page URL to audit. URLs with credentials, localhost, private IPs, or private DNS targets are blocked.
timeoutSeconds	integer	No	Request timeout. Values are clamped from 3 to 30 seconds. Default is 10.
maxHtmlBytes	integer	No	Maximum HTML bytes to read. Values are clamped from 100,000 bytes to 2 MB. Default is 1 MB.

Output

Field	Type	Description
inputUrl	string	Original URL supplied by the user.
normalizedInputUrl	string	URL after default HTTPS normalization.
finalUrl	string	Final URL after safe redirects.
ok	boolean	True when the page was fetched successfully.
status	integer or null	HTTP status code for the final response.
checkedAt	string	ISO 8601 timestamp for the audit.
score	integer	Readiness score from 0 to 100.
grade	string	Letter grade from A to F.
scriptCount	integer	Number of application/ld+json scripts found.
validItemCount	integer	Number of parsed JSON-LD objects, including @graph nodes.
schemaTypes	array	Unique detected @type values.
itemsMissingType	integer	Count of JSON-LD items without @type.
parseErrors	array	JSON parse errors with script index and message.
issues	array	Human-readable audit issues.
recommendations	array	Suggested fixes.
error	string or null	Fetch or validation error, if any.

Example input

{
  "startUrl": "https://example.com/",
  "timeoutSeconds": 10,
  "maxHtmlBytes": 1048576
}

Example output

{
  "inputUrl": "https://example.com/",
  "normalizedInputUrl": "https://example.com/",
  "finalUrl": "https://example.com/",
  "ok": true,
  "status": 200,
  "checkedAt": "2026-07-10T12:00:00.000Z",
  "score": 90,
  "grade": "A",
  "scriptCount": 1,
  "validItemCount": 1,
  "schemaTypes": ["Organization"],
  "itemsMissingType": 0,
  "parseErrors": [],
  "issues": [],
  "recommendations": [],
  "error": null
}

Security

This actor only fetches public HTTP and HTTPS pages. It rejects URL credentials, non-HTTP schemes, private IPv4 and IPv6 literals, localhost-style targets, and DNS resolutions to private ranges. Redirect targets are revalidated before fetching. Response size is capped to reduce accidental large downloads.

Pricing

Event	Price
Actor start	$0.005
Page audited	$0.01

Typical cost for one page audit is about $0.015.

FAQ

Does this validate against Google Rich Results requirements?

No. It checks JSON-LD presence, parseability, detected types, missing @type, and common SEO readiness signals. Use Google Rich Results Test for Google-specific eligibility.

Does it crawl a whole website?

No. It audits one page per run. Use multiple runs or a wrapper workflow for batches.

Does it require login or browser automation?

No. It fetches public HTML with a simple HTTP request and does not collect credentials.

What is the keep metric?

Keep or improve if it receives organic Store impressions, runs, revenue, or inbound questions within 60 to 90 days. Archive it if it receives no discovery and no usage.