Home / API docs / Webbie Site API
Design & Assets

Webbie Site API

POST /api/webbie/site $0.50 per call USDC on Base · x402

WHOLE-SITE generator — up to 6 finished, consistent HTML pages in one call. POST a site name, shared branding (colors, logo, footer), and a pages[] array (each with page_name, headline, content sections, hero images); one seed styles every page identically and a shared nav linking all pages is built automatically. Returns ready-to-upload files plus nav.json. The multi-page version of /api/webbie/page.

Parameters

NameInDescription
site_namebodyrequiredBrand/site name (required)
seedbodyStyle seed — omit for random; returned so you can add pages later
templatebodyhorizon, split, or editorial; omit to let the seed choose
colorsbody1-2 accents, hex or CSS names
logo_urlbodyNav logo image URL
logobodyAuto-generate mark: {query, colors, shape}
footerbodyFooter text (all pages)
pagesbodyrequired1-6 pages: [{page_name, headline, title, caption, tagline, hero_images, content, cta}]

Example request

curl -X POST "https://api.webbersites.com/api/webbie/site" \
  -H "Content-Type: application/json" \
  -d '{"site_name":"Northwind","seed":"nw-2026","colors":["#ff6b35"],"pages":[{"page_name":"home","headline":"Data for autonomous agents"},{"page_name":"pricing","headline":"Simple pricing"}]}'
# first call returns 402 + payment requirements; an x402 client pays and retries automatically

Example response

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