previewPageAudit
Run an instant quality audit on a single URL to check Open Graph and social metadata, get a score with issues, and view mock social previews.
Instructions
Run an instant quality audit of a single URL. Returns a score (0–100), a score label (Well Optimized / Good / Needs Attention / Poor), a breakdown of Open Graph and social metadata checks, any issues found, and mock social previews for Facebook, Twitter, LinkedIn, and Google.
This is a synchronous, single-URL check — it returns results immediately without creating a persisted audit. It does not count against your audit page quota.
Score labels: Well Optimized (≥90) · Good (≥80) · Room for Improvement (≥70) · Needs Attention (≥60) · Poor (<60)
Pick the right tool: previewPageAudit → Instant check of one URL (no quota consumed, returns immediately) startSiteAudit → Crawl and audit an entire domain (async, uses quota)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The full URL of the page to audit (e.g. https://example.com/product). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| score | Yes | Quality score 0–100 | |
| checks | No | Individual check results keyed by check name | |
| issues | No | Issues found on the page with severity and guidance | |
| summary | No | ||
| previews | No | Social card mock previews: facebook, twitter, linkedin, google | |
| scoreLabel | Yes | Human-readable score tier |