Public Structured Data & Rich Results Readiness Agent

Turn public web pages into compact structured-data readiness records for SEO audits, AI agents, RAG preparation, content QA, and rich-result hygiene checks.

The Actor fetches the supplied public page URLs and audits JSON-LD, Microdata, and RDFa signals. It returns Schema.org types, detected formats, fields, missing recommended fields, rich-result candidate types, diagnostics, a readiness score, confidence score, and a stable structured-data hash for change tracking.

Rich-result candidate signals are not a guarantee that Google or another search engine will display a rich result. Search engines apply their own eligibility, quality, policy, and rendering rules. This Actor reports public page evidence and readiness diagnostics.

How To Use It

For a first-pass inventory, provide public page URLs and leave Schema focus types empty:

{
  "pageUrls": ["https://blog.apify.com/web-scraping-guide/"],
  "schemaFocusTypes": [],
  "previousStructuredDataRecords": [],
  "requestTimeoutSecs": 20
}

For targeted checks, add schemaFocusTypes such as Article, Product, FAQPage, BreadcrumbList, Organization, WebSite, or SoftwareApplication. If focus types are supplied, useful-result charging requires at least one matching Schema.org type in the public page evidence.

For repeat monitoring, pass previous dataset records from this Actor in previousStructuredDataRecords. If the structured-data hash is unchanged, the record is written as changeStatus: "unchanged" without the useful event charge.

What It Finds

Useful evidence can include:

• JSON-LD, Microdata, and RDFa formats detected on the page
• Schema.org types and structured-data item counts
• fields found on each structured-data item
• missing recommended fields for common rich-result candidate types
• rich-result candidate categories such as Article, Product, FAQPage, HowTo, BreadcrumbList, Recipe, Review, VideoObject, and SoftwareApplication
• matched focus types, readiness score, confidence score, diagnostics, evidence URLs, and a stable structured-data hash

Pricing

Pay-per-event pricing is designed to stay predictable:

• apify-actor-start: a tiny run-start fee
• useful-structured-data-readiness-result: charged only for useful page-level structured-data readiness records
• no apify-default-dataset-item

If schemaFocusTypes are supplied, useful-result charging requires at least one matching Schema.org type. Invalid inputs, duplicate equivalent URLs, private-network targets, query/fragment/token inputs, failed fetches, focus misses, unchanged records, and blank/weak pages do not charge the useful event.

Pages with no structured data can still be useful paid readiness audit results when the public HTML was fetched and clear diagnostics are returned.

Output

Each page returns one record with fields such as:

• status, changeStatus, inputUrl, finalUrl, and siteOriginUrl
• pageTitle, pageDescription, schemaTypes, and formatsDetected
• structuredDataItems, structuredDataItemCount, and richResultCandidates
• matchedSchemaFocusTypes, structuredDataHash, readinessScore, confidenceScore, missingFields, and diagnostics

Boundaries

This Actor is a page-level structured-data readiness audit, not Google's Rich Results Test, a SERP scraper, rank tracker, website crawler, screenshot tool, article extractor, product extractor, API-docs scanner, contact finder, or legal/trust evidence tool.

It fetches only the provided public page URLs. It does not log in, use cookies, render JavaScript, run a full-site crawl, bypass paywalls, scrape search-engine results, or enrich private persons.

Not For

This Actor is not an official rich-results validator, rank tracker, sitemap crawler, Lighthouse runner, JavaScript renderer, search-engine scraper, or SEO recommendation engine. It extracts bounded public structured-data evidence for downstream review.