Home / API docs / Schema.org Generator API
SEO & Publishing

Schema.org Generator API

POST /api/schema/generate $0.02 per call USDC on Base · x402

Generate valid, current-spec schema.org JSON-LD from plain fields — the complement to /api/schema/audit. POST {type, fields}; returns correctly nested JSON-LD, a ready-to-embed <script> tag, and a self-audit. Types: Product, Review, Article, Recipe, VideoObject, LocalBusiness, Organization, BreadcrumbList. Current to 2026 Google guidance (interactionStatistic, Key Moments clips, etc).

Parameters

NameInDescription
typebodyrequiredProduct, Review, Article, Recipe, VideoObject, LocalBusiness, Organization, or BreadcrumbList
fieldsbodyrequiredPlain fields for the type, e.g. {name, price, brand} for Product

Example request

curl -X POST "https://api.webbersites.com/api/schema/generate" \
  -H "Content-Type: application/json" \
  -d '{"type":"Product","fields":{"name":"Widget Pro","price":19.99,"priceCurrency":"USD","brand":"Acme","image":"https://example.com/w.jpg"}}'
# first call returns 402 + payment requirements; an x402 client pays and retries automatically

Example response

{
    "type": "Product",
    "jsonld": {
        "@context": "https://schema.org",
        "@type": "Product",
        "name": "Widget Pro",
        "offers": {
            "@type": "Offer",
            "price": "19.99",
            "priceCurrency": "USD"
        }
    },
    "script_tag": "<script type=\"application/ld+json\">…</script>",
    "self_audit": {
        "rich_result_status": "active",
        "required_missing": []
    }
}
MCP tool: post_schema_generate — via npx -y webbersites-x402-mcp (local, key stays on your machine) or the remote endpoint https://api.webbersites.com/mcp.

How payment works

There is no signup and no API key. Call the endpoint; it replies 402 Payment Required with machine-readable payment requirements. Your client signs a USDC transfer authorization (EIP-3009, gasless) and retries with the X-PAYMENT header — @x402/fetch does this automatically. See the overview for a working snippet.