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. Current limits are about 20 checks per minute for the same IP and target host, with a higher per-IP ceiling across all hosts.