API Reference
Overview
All HTTP endpoints exposed by the demo Describe API.
| Method | Path | Purpose |
|---|---|---|
| GET | /describe/{domain} | Brand metadata for a single domain |
| GET | /search | Typeahead or match search over the catalog |
| GET | /domains | Newline-separated list of every domain in the demo |
Conventions
- Content-Type is
application/json; charset=utf-8for all JSON routes;text/plainfor/domains. - Errors are JSON:
{"error": "<message>", "domain": "<requested>"}. - Domain casing. Inputs are lowercased before lookup. Slashes and backslashes are rejected with
400. - Root domains only. Pass the registrable domain —
stripe.com, notwww.stripe.comorpages.stripe.com. The catalog is keyed by canonical roots; arbitrary subdomains aren't resolved to their parent and will404. - CORS is wide open. Every endpoint — including
/img/for brand assets — sendsAccess-Control-Allow-Origin: *. Call the demo directly from notebooks, codepens, or browser apps; no server-side proxy needed. Images are alsocrossorigin-safe for canvas and Worker pipelines.