PreviewChecks

PreviewChecks API

Run the same social preview checks from scripts, release workflows or internal QA tools.

Endpoint

Send a GET request with a URL-encoded page URL. Bare domains are normalized to HTTPS. 

curl "https://previewchecks.com/api/v1/check?url=https%3A%2F%2Fpreviewchecks.com"

Use API when

  • Run a launch checklist before publishing a page.
  • Validate preview metadata from CI or release scripts.
  • Check whether crawler-like requests can reach production URLs.

Response

The response includes the normalized URL, final URL, summary score, preview card, platform checks, crawler results, metadata, image diagnostics, TLS result and ordered fixes.

summary.status

Highest-level result: pass, notice, warning or error.

summary.score

0-100 score after crawler, metadata, image and platform checks.

issues

Ordered fixes with severity, detail and suggested action.

platforms

Per-platform results for Open Graph, X, Facebook, LinkedIn, Pinterest and chat previews.

Limits

The public API is free for fair-use validation. It allows 20 uncached checks per minute for the same client IP and target host, and 60 uncached checks per minute for that IP across all hosts. Cached responses do not use that allowance.