{"openapi":"3.0.3","info":{"title":"Headless Webpage Screenshot & Social Card API","description":"Edge-based headless website screenshot, OpenGraph 1200x630 social card generator, browser mockup framing, and social media image automation with zero token costs.","version":"1.0.0","contact":{"name":"TopAI SaaS Dev","email":"top.ai.saas@gmail.com"}},"servers":[{"url":"https://headless-screenshot.topaisaas.workers.dev","description":"Cloudflare Workers Edge Production"}],"paths":{"/v1/social-card":{"post":{"summary":"Generate 1200x630 Social Preview Card","description":"Generates high-definition OpenGraph and Twitter card banners with title, subtitle, branding and custom color themes.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title"],"properties":{"title":{"type":"string","example":"Announcing Autonomous AI Agents 2.0"},"subtitle":{"type":"string","example":"Deploy sub-second serverless micro-SaaS with zero token costs"},"brand_name":{"type":"string","example":"TopAI Studio"},"domain":{"type":"string","example":"topaisaas.com"},"badge":{"type":"string","example":"⚡ Product Launch"},"theme":{"type":"string","enum":["dark","yellow_electric","neon","minimal"],"default":"dark"},"format":{"type":"string","enum":["json","svg"],"default":"json"}}}}}},"responses":{"200":{"description":"Social card generated successfully"},"400":{"description":"Invalid parameters"}}},"get":{"summary":"Generate Social Card as Direct Image","parameters":[{"name":"title","in":"query","required":true,"schema":{"type":"string"}},{"name":"subtitle","in":"query","schema":{"type":"string"}},{"name":"theme","in":"query","schema":{"type":"string","default":"dark"}}],"responses":{"200":{"description":"Returns direct image/svg+xml"}}}},"/v1/screenshot":{"post":{"summary":"Capture Website Screenshot & Mockup Frame","description":"Renders a clean browser window device mockup snapshot of the target web page with extracted titles, navigation and content cards.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","example":"https://stripe.com"},"viewport":{"type":"string","enum":["desktop","tablet","mobile"],"default":"desktop"},"dark_mode":{"type":"boolean","default":true},"format":{"type":"string","enum":["json","svg"],"default":"json"}}}}}},"responses":{"200":{"description":"Screenshot captured successfully"},"400":{"description":"Failed to capture or invalid URL"}}},"get":{"summary":"Direct Screenshot Image Preview","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Returns direct image/svg+xml snapshot"}}}},"/v1/extract/og-metadata":{"post":{"summary":"Audit & Extract OpenGraph Social Tags","description":"Scrapes meta tags, twitter card, og:image, and performs social audit checks.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","example":"https://github.com"}}}}}},"responses":{"200":{"description":"Metadata returned"}}}},"/v1/health":{"get":{"summary":"System Healthcheck","responses":{"200":{"description":"Service is healthy"}}}}}}