Home / API docs / Webbie Page Generator API
Design & Assets

Webbie Page Generator API

POST /api/webbie/page $0.02 per call USDC on Base · x402

Webbie page generator: site name, headline, tagline, hero images, content sections, nav, colors — returns a finished responsive standalone HTML page. Three templates (horizon, split, editorial); the seed deterministically picks template + fonts + accent, so reusing it across calls builds a consistent multi-page site. Nav loads from an editable nav.json at view-time. No AI — deterministic templating.

Parameters

NameInDescription
site_namebodyrequiredBrand/site name (required)
headlinebodyHero headline
page_namebody'home' = index.html (default), or e.g. 'about'
seedbodyReuse the same seed on every call for one consistent site style
templatebodyhorizon, split, or editorial; omit to let the seed choose
titlebodyBrowser/SEO title
captionbodyKicker above the headline
taglinebodySupporting line + meta description
hero_imagesbodyFirst = hero, extras = gallery
logo_urlbodyNav logo image URL
logobodyAuto-generate mark: {query, colors, shape}
colorsbody1-2 accents, hex or CSS names
ctabody{text, href}
contentbodySections: [{heading, body}]
navbody[{label, href}] — echoed as nav_json
footerbodyFooter text

Example request

curl -X POST "https://api.webbersites.com/api/webbie/page" \
  -H "Content-Type: application/json" \
  -d '{"site_name":"Northwind","headline":"Data for autonomous agents","seed":"nw-2026","template":"horizon","hero_image":"https://example.com/hero.jpg","colors":["#ff6b35"],"cta":{"text":"Get started","href":"docs.html"}}'
# first call returns 402 + payment requirements; an x402 client pays and retries automatically

Example response

{
    "seed": "nw-2026",
    "template": "horizon",
    "filename": "index.html",
    "html": "<!DOCTYPE html>…",
    "nav_json": {
        "links": []
    }
}
MCP tool: post_webbie_page — 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.