Open Graph Preview API

POST https://api.findutils.com/api/tools/open-graph-preview/execute

Extract Open Graph and Twitter Card tags from an HTML document (or take them as fields), and return the parsed values, validation issues (missing or too-long title/description/image/url/card), and regenerated <meta> tags. Does not fetch URLs — pass the page HTML.

Open the tool Try it

Request body

application/json

html

string optional

HTML source to parse for og:* and twitter:* meta tags. Optional when tag values are given directly.
og_title

string optional

og:title value (overrides the parsed value).
og_description

string optional

og:description value.
og_image

string optional

og:image URL.
og_url

string optional

og:url value.
og_type

string optional

og:type value. Default "website". One of website · article · product · profile · video.movie · video.episode · music.song · book.
og_site_name

string optional

og:site_name value.
twitter_card

string optional

twitter:card value. Default "summary_large_image". One of summary · summary_large_image · app · player.
twitter_title

string optional

twitter:title value.
twitter_description

string optional

twitter:description value.
twitter_image

string optional

twitter:image URL.

Example arguments

Verified

{
  "html": "<meta property=\"og:title\" content=\"Hello\"><meta property=\"og:description\" content=\"A demo page.\"><meta property=\"og:image\" content=\"https://example.com/og.png\"><meta property=\"og:url\" content=\"https://example.com/\">"
}

curl -X POST https://api.findutils.com/api/tools/open-graph-preview/execute \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<meta property=\"og:title\" content=\"Hello\"><meta property=\"og:description\" content=\"A demo page.\"><meta property=\"og:image\" content=\"https://example.com/og.png\"><meta property=\"og:url\" content=\"https://example.com/\">"
  }'

const response = await fetch('https://api.findutils.com/api/tools/open-graph-preview/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"html":"<meta property=\"og:title\" content=\"Hello\"><meta property=\"og:description\" content=\"A demo page.\"><meta property=\"og:image\" content=\"https://example.com/og.png\"><meta property=\"og:url\" content=\"https://example.com/\">"}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/open-graph-preview/execute",
    json={"html":"<meta property=\"og:title\" content=\"Hello\"><meta property=\"og:description\" content=\"A demo page.\"><meta property=\"og:image\" content=\"https://example.com/og.png\"><meta property=\"og:url\" content=\"https://example.com/\">"},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/open-graph-preview/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"html":"<meta property=\"og:title\" content=\"Hello\"><meta property=\"og:description\" content=\"A demo page.\"><meta property=\"og:image\" content=\"https://example.com/og.png\"><meta property=\"og:url\" content=\"https://example.com/\">"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call open_graph_preview from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: None
REST id: open-graph-preview
MCP name: open_graph_preview
Category: SEO
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More SEO tools

More to explore