Social Preview Validator - Open Graph & Twitter Cards

Check how public web pages are prepared for social sharing before broken titles, missing descriptions, or dead preview images reach production. The Actor validates Open Graph, Twitter/X card metadata, canonical links, and preview-image reachability, then returns structured issues and a 0-100 score.

Why use this Actor

Manual preview checks do not scale across product catalogs, editorial archives, landing pages, or client sites. This Actor gives teams a repeatable QA layer with explicit failure reasons instead of a vague pass/fail result.

Key features

• Extracts Open Graph title, description, image, URL, type, and site name.
• Extracts Twitter/X card, title, description, image, and site metadata.
• Checks canonical-link presence.
• Optionally verifies whether the Open Graph image is reachable and served as an image.
• Flags missing fields, cross-domain og:url, unreachable images, and unusually long social text.
• Returns page title, meta description, HTTP status, issue count, and 0-100 score.
• Supports up to 100 public URLs per run with controlled concurrency.

Input

{
  "urls": ["https://www.python.org"],
  "verifyImages": true,
  "concurrency": 5
}

Output

Each URL produces a structured record containing final URL, HTTP status, page metadata, Open Graph data, Twitter/X card data, canonical URL, optional image validation, issue list, issue count, and score.

Example

{
  "ok": true,
  "score": 82,
  "openGraph": {"title": "Example", "image": "https://example.com/preview.png"},
  "twitter": {"card": "summary_large_image"},
  "issues": ["canonical_missing"]
}

Use cases

• Editorial and publishing QA
• E-commerce product-page checks
• Landing-page launch validation
• Social-sharing regression monitoring
• Agency audits across client websites
• CI-style metadata checks before releases

Pricing

Pay per result. The current price is $0.00075 per checked URL, equivalent to $0.75 per 1,000 results.

Limitations

• The score is a QA heuristic, not a guarantee of how every social platform will render a page.
• Some platforms cache previews independently; this Actor checks the current public page metadata.
• JavaScript-generated metadata may not be visible to a lightweight HTML request.
• WAFs, authentication, CAPTCHAs, or blocked image requests can affect validation.

Responsible use

Only public HTTP/HTTPS pages are checked. Private-network destinations and unsafe redirects are blocked.