{ "what_this_is": "The whole shelf. Facets, every legal value, and real counts — no specimens. Call this first, pick a facet, then GET /api/v1/library/specimens. The inventory is LUMPY and these counts are why: hero and faq are hundreds, stat_proof and reviews are single digits.", "design_system": { "what_this_is": "uxxray's OWN design tokens. If you are generating a concept FOR this product, use these — do not invent a palette, and do not design a dark variant: there is no dark site.", "live_theme": "paper", "live_theme_note": "signal-shell.js sets on every published surface. Design against `paper` unless told otherwise; the other themes are history, not options.", "tokens": { "ux-bg": "#FBFAF8", "ux-surface": "#FFFFFF", "ux-raised": "#FFFFFF", "ux-overlay": "rgba(22,22,26,.86)", "ux-code-bg": "#F3F1EC", "ux-ink": "#16161A", "ux-ink-soft": "#3E3E46", "ux-ink-muted": "#6B6B76", "ux-code-ink": "#3E3E46", "ux-on-brand": "#ffffff", "ux-brand": "#C2087F", "ux-brand-hover": "#9c0665", "ux-brand-ink": "#B40776", "ux-brand-tint": "rgba(194,8,127,.10)", "ux-accent": "#5b21b6", "ux-accent-ink": "#5b21b6", "ux-accent-tint": "rgba(91,33,182,.10)", "ux-grad": "linear-gradient(120deg,#C2087F,#9c0665)", "ux-glass": "rgba(251,250,248,.86)", "ux-hairline": "linear-gradient(90deg,transparent,#C2087F,transparent)", "ux-line": "#E7E4DE", "ux-line-strong": "#D8D4CC", "ux-focus": "#C2087F", "ux-focus-ring": "0 0 0 3px rgba(194,8,127,.35)", "ux-ok": "#0F7A53", "ux-ok-tint": "rgba(15,122,83,.10)", "ux-warn": "#8A5A06", "ux-warn-tint": "rgba(138,90,6,.10)", "ux-danger": "#B3243C", "ux-danger-tint": "rgba(179,36,60,.09)", "ux-info": "#2563EB", "ux-info-tint": "rgba(37,99,235,.10)", "ux-band-a": "#0F7A53", "ux-band-b": "#3F7A1F", "ux-band-c": "#8A5A06", "ux-band-d": "#9A4A12", "ux-band-e": "#A6371C", "ux-band-f": "#B3243C", "ux-radius-xs": "4px", "ux-radius-sm": "6px", "ux-radius-md": "10px", "ux-radius-lg": "14px", "ux-radius-pill": "99px", "ux-space-1": "4px", "ux-space-2": "8px", "ux-space-3": "12px", "ux-space-4": "16px", "ux-space-5": "24px", "ux-space-6": "34px", "ux-space-7": "48px", "ux-space-8": "64px", "ux-text-display": "clamp(38px,6vw,68px)", "ux-text-h1": "clamp(30px,4.6vw,46px)", "ux-text-h2": "clamp(22px,3vw,31px)", "ux-text-h3": "19px", "ux-text-body": "17px", "ux-text-small": "14.5px", "ux-text-caption": "12.5px", "ux-text-micro": "11px", "ux-weight-normal": "400", "ux-weight-medium": "500", "ux-weight-semibold": "600", "ux-weight-bold": "700", "ux-weight-heavy": "800", "ux-leading-solid": "1", "ux-leading-tight": "1.06", "ux-leading-snug": "1.4", "ux-leading-normal": "1.6", "ux-leading-loose": "1.75", "ux-track-tight": "-.03em", "ux-track-snug": "-.01em", "ux-track-normal": "0", "ux-track-wide": ".04em", "ux-track-caps": ".12em", "ux-track-kicker": ".2em", "ux-font-sans": "'Hanken Grotesk',-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif", "ux-font-mono": "'JetBrains Mono',ui-monospace,'SF Mono',Menlo,monospace", "ux-font-display": "'Fraunces',Georgia,'Times New Roman',serif", "ux-shadow-sm": "0 1px 2px rgba(22,22,26,.06)", "ux-shadow-md": "0 10px 26px -14px rgba(22,22,26,.28)", "ux-shadow-lg": "0 26px 60px -28px rgba(22,22,26,.40)", "ux-glow": "0 0 0 1px rgba(194,8,127,.18)", "ux-dur-fast": "120ms", "ux-dur-base": "200ms", "ux-dur-slow": "320ms", "ux-ease-out": "cubic-bezier(.2,.7,.2,1)", "ux-ease-in-out": "cubic-bezier(.65,.05,.35,.95)", "ux-z-raised": "10", "ux-z-sticky": "100", "ux-z-overlay": "1000", "ux-z-modal": "1100", "ux-z-toast": "1200", "ux-maxw": "1080px", "ux-maxw-narrow": "720px", "ux-maxw-wide": "1360px" }, "all_themes_note": "Only the live theme is served here. The others are history, not options." }, "corpus": { "funnels_measured": 1777, "pages_analyzed": 2703, "excluded": "Funnels whose crawl never reached the footer are excluded from every count here — a truncated capture would contribute a \"section\" that is only where the crawl stopped." }, "explore": { "param": "scope", "default": "broad", "tiers": [ { "scope": "narrow", "returns": 5, "payload": "Full specimen: crop coords, the funnel's measured /100, EVERY tactic receipt with its verbatim on-page evidence string, tokens_url and source_bundle_url." }, { "scope": "broad", "returns": 20, "payload": "Working set: crop coords, score, and which tactics the funnel measurably runs (pattern ids + counts) WITHOUT the verbatim evidence strings. Re-request one specimen at scope=narrow for its quotes." }, { "scope": "full", "returns": "every match (capped at 500)", "payload": "The roster: specimen_ref, slug, domain, funnel_type, score, grade. No crops, no receipts, no URLs. This is the map of what exists, not the merchandise." } ], "note": "Breadth is yours to choose, per round. Silence gets you 20." }, "axes": { "rule": "Select on ONE axis per request: kind (+archetype/template) OR playbook. Naming both is a 400 — applying one and dropping the other would return a set that looks like it honoured the whole query.", "cross_axis": { "enabled": false, "note": "off for now; the code path exists behind one constant" }, "kind": { "param": "kind", "default": "section", "values": [ { "kind": "section", "label": "Section", "what": "One measured band of a real page — a hero, a pricing table, an FAQ — with crop coordinates onto the full-page screenshot it was measured from.", "facet": "archetype", "retrievable": true, "available": 6218, "values": [ { "value": "hero", "label": "Hero", "available": 2237, "by_funnel_type": { "saas": 1818, "ecommerce": 273, "affiliate": 132, "lead_gen": 14 }, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=section&archetype=hero" }, { "value": "faq", "label": "FAQ", "available": 1344, "by_funnel_type": { "saas": 1153, "ecommerce": 131, "affiliate": 54, "lead_gen": 6 }, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=section&archetype=faq" }, { "value": "pricing", "label": "Pricing", "available": 771, "by_funnel_type": { "saas": 673, "ecommerce": 76, "affiliate": 20, "lead_gen": 2 }, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=section&archetype=pricing" }, { "value": "logo_wall", "label": "Logo Wall", "available": 650, "by_funnel_type": { "saas": 532, "ecommerce": 96, "affiliate": 19, "lead_gen": 3 }, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=section&archetype=logo_wall" }, { "value": "cta_band", "label": "CTA", "available": 416, "by_funnel_type": { "saas": 342, "ecommerce": 63, "affiliate": 11 }, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=section&archetype=cta_band" }, { "value": "feature_grid", "label": "Features", "available": 391, "by_funnel_type": { "saas": 317, "ecommerce": 44, "affiliate": 29, "lead_gen": 1 }, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=section&archetype=feature_grid" }, { "value": "comparison", "label": "Comparison", "available": 188, "by_funnel_type": { "saas": 166, "ecommerce": 14, "affiliate": 8 }, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=section&archetype=comparison" }, { "value": "reviews", "label": "Reviews", "available": 100, "by_funnel_type": { "saas": 52, "ecommerce": 43, "affiliate": 5 }, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=section&archetype=reviews" }, { "value": "email_capture", "label": "Email Capture", "available": 74, "by_funnel_type": { "saas": 50, "ecommerce": 19, "affiliate": 3, "lead_gen": 2 }, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=section&archetype=email_capture" }, { "value": "stat_proof", "label": "Stats", "available": 47, "by_funnel_type": { "saas": 40, "affiliate": 5, "ecommerce": 2 }, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=section&archetype=stat_proof" } ] }, { "kind": "page", "label": "Page", "what": "A whole measured page: its section sequence in order, its full-page screenshot, and the tactics the funnel it belongs to measurably runs.", "facet": "template", "retrievable": true, "available": 1344, "values": [ { "value": "hero", "label": "Hero", "available": 178, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero" }, { "value": "hero>faq", "label": "The Bare Explainer", "available": 172, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Efaq" }, { "value": "hero>pricing>faq", "label": "The Pricing Page", "available": 79, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Epricing%3Efaq" }, { "value": "hero>logo_wall", "label": "The Trust Wall", "available": 63, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Elogo_wall" }, { "value": "hero>logo_wall>faq", "label": "The Objection-Handler", "available": 56, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Elogo_wall%3Efaq" }, { "value": "hero>pricing", "label": "Hero + Pricing", "available": 37, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Epricing" }, { "value": "hero>logo_wall>pricing>faq", "label": "Hero + Logo Wall + Pricing + FAQ", "available": 28, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Elogo_wall%3Epricing%3Efaq" }, { "value": "hero>feature_grid", "label": "Hero + Features", "available": 28, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Efeature_grid" }, { "value": "hero>cta_band", "label": "Hero + CTA", "available": 28, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Ecta_band" }, { "value": "hero>faq>cta_band", "label": "Hero + FAQ + CTA", "available": 23, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Efaq%3Ecta_band" }, { "value": "hero>feature_grid>faq", "label": "Hero + Features + FAQ", "available": 23, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Efeature_grid%3Efaq" }, { "value": "faq", "label": "FAQ", "available": 21, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=faq" }, { "value": "hero>logo_wall>cta_band", "label": "The Trust-and-Ask", "available": 18, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Elogo_wall%3Ecta_band" }, { "value": "hero>comparison>faq", "label": "Hero + Comparison + FAQ", "available": 17, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Ecomparison%3Efaq" }, { "value": "hero>logo_wall>logo_wall", "label": "Hero + Logo Wall + Logo Wall", "available": 16, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Elogo_wall%3Elogo_wall" }, { "value": "feature_grid", "label": "Features", "available": 16, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=feature_grid" }, { "value": "pricing>faq", "label": "Pricing + FAQ", "available": 13, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=pricing%3Efaq" }, { "value": "hero>feature_grid>pricing>faq", "label": "Hero + Features + Pricing + FAQ", "available": 12, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Efeature_grid%3Epricing%3Efaq" }, { "value": "hero>pricing>faq>cta_band", "label": "Hero + Pricing + FAQ + CTA", "available": 11, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Epricing%3Efaq%3Ecta_band" }, { "value": "logo_wall>faq", "label": "Logo Wall + FAQ", "available": 10, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=logo_wall%3Efaq" }, { "value": "logo_wall", "label": "Logo Wall", "available": 10, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=logo_wall" }, { "value": "hero>logo_wall>logo_wall>faq", "label": "Hero + Logo Wall + Logo Wall + FAQ", "available": 10, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Elogo_wall%3Elogo_wall%3Efaq" }, { "value": "hero>cta_band>faq", "label": "Hero + CTA + FAQ", "available": 8, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Ecta_band%3Efaq" }, { "value": "hero>logo_wall>faq>cta_band", "label": "Hero + Logo Wall + FAQ + CTA", "available": 8, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Elogo_wall%3Efaq%3Ecta_band" }, { "value": "hero>faq>logo_wall", "label": "Hero + FAQ + Logo Wall", "available": 8, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Efaq%3Elogo_wall" }, { "value": "hero>email_capture", "label": "Hero + Email Capture", "available": 7, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Eemail_capture" }, { "value": "pricing", "label": "Pricing", "available": 7, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=pricing" }, { "value": "cta_band", "label": "CTA", "available": 7, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=cta_band" }, { "value": "hero>pricing>logo_wall>faq", "label": "Hero + Pricing + Logo Wall + FAQ", "available": 6, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Epricing%3Elogo_wall%3Efaq" }, { "value": "hero>logo_wall>feature_grid", "label": "Hero + Logo Wall + Features", "available": 6, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Elogo_wall%3Efeature_grid" }, { "value": "hero>pricing>pricing>faq", "label": "Hero + Pricing + Pricing + FAQ", "available": 6, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Epricing%3Epricing%3Efaq" }, { "value": "hero>pricing>faq>logo_wall", "label": "Hero + Pricing + FAQ + Logo Wall", "available": 6, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Epricing%3Efaq%3Elogo_wall" }, { "value": "hero>pricing>cta_band", "label": "Hero + Pricing + CTA", "available": 6, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Epricing%3Ecta_band" }, { "value": "hero>pricing>email_capture>faq", "label": "Hero + Pricing + Email Capture + FAQ", "available": 6, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Epricing%3Eemail_capture%3Efaq" }, { "value": "hero>cta_band>pricing", "label": "Hero + CTA + Pricing", "available": 5, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Ecta_band%3Epricing" }, { "value": "comparison>faq", "label": "Comparison + FAQ", "available": 5, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=comparison%3Efaq" }, { "value": "hero>logo_wall>pricing", "label": "Hero + Logo Wall + Pricing", "available": 5, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Elogo_wall%3Epricing" }, { "value": "hero>feature_grid>cta_band", "label": "Hero + Features + CTA", "available": 5, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Efeature_grid%3Ecta_band" }, { "value": "hero>feature_grid>logo_wall", "label": "Hero + Features + Logo Wall", "available": 5, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Efeature_grid%3Elogo_wall" }, { "value": "hero>logo_wall>pricing>faq>cta_band", "label": "Hero + Logo Wall + Pricing + FAQ + CTA", "available": 5, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=page&template=hero%3Elogo_wall%3Epricing%3Efaq%3Ecta_band" } ], "values_note": "Top 40 recurring section-skeletons (signatures seen on 2+ pages). Omit ?template= to get every page." }, { "kind": "element", "label": "Element", "what": "One atomic UI piece cropped to its exact measured pixels — a price anchor, a rating, a guarantee badge, a scarcity line.", "facet": "element_type", "retrievable": true, "available": 1016, "values": [ { "value": "strikethrough_price", "label": "Price anchor", "available": 310, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=element&element_type=strikethrough_price" }, { "value": "rating", "label": "Rating", "available": 293, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=element&element_type=rating" }, { "value": "no_credit_card", "label": "No credit card", "available": 293, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=element&element_type=no_credit_card" }, { "value": "guarantee", "label": "Guarantee", "available": 105, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=element&element_type=guarantee" }, { "value": "countdown", "label": "Countdown", "available": 15, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?kind=element&element_type=countdown" } ], "values_note": "One specimen = one cropped element image. A type is listed only if at least one crop succeeded on a public funnel." } ] }, "playbook": { "param": "playbook", "selects": "Funnels measurably running one named play, served as page specimens with the play's quoted evidence.", "values": [ { "value": "pre_sold", "label": "The ad sells, the page confirms", "available": 26, "detectable": true, "lever_only": false, "why_not": null, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?playbook=pre_sold" }, { "value": "bridge", "label": "An article sells first", "available": 14, "detectable": true, "lever_only": false, "why_not": null, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?playbook=bridge" }, { "value": "intent_match", "label": "A comparison page", "available": 95, "detectable": true, "lever_only": false, "why_not": null, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?playbook=intent_match" }, { "value": "quiz", "label": "A quiz first", "available": 6, "detectable": true, "lever_only": false, "why_not": null, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?playbook=quiz" }, { "value": "long_sale", "label": "One long sales page", "available": 0, "detectable": false, "lever_only": false, "why_not": "video/long-form presentation is not extracted at capture time", "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?playbook=long_sale" }, { "value": "second_sale", "label": "Subscription by default", "available": 0, "detectable": true, "lever_only": true, "why_not": null, "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?playbook=second_sale" }, { "value": "recovery", "label": "Winning back a leaver", "available": 0, "detectable": false, "lever_only": false, "why_not": "abandonment flows and retargeting are unobservable from a crawl", "specimens_url": "https://api.uxxray.com/api/v1/library/specimens?playbook=recovery" } ], "note": "A play with 0 matches is not a gap in the library — some plays (long sale, recovery) run through ads and email, which a crawl cannot observe. `why_not` says so per play." } }, "filters": { "funnel_type": { "param": "funnel_type", "composes_with": "every axis", "why": "Industry cannot select on its own — \"saas\" is not a specimen — so it can only narrow a selection made by an axis.", "values": [ { "value": "saas", "available": 1107 }, { "value": "ecommerce", "available": 146 }, { "value": "affiliate", "available": 85 }, { "value": "lead_gen", "available": 6 } ] }, "exclude_seen": { "params": [ "exclude_seen", "exclude_seen_session", "exclude_seen_project" ], "why": "So a second round never re-serves what you already built from. exclude_seen_project needs the x-uxxray-visitor header and unions every session YOU opened for that project." } }, "next": { "specimens": "https://api.uxxray.com/api/v1/library/specimens?kind=section&archetype=hero&scope=broad", "roster": "https://api.uxxray.com/api/v1/library/specimens?kind=section&archetype=hero&scope=full", "one_task": "https://api.uxxray.com/api/v1/library/brief?task=build_hero_with_proof" }, "generated_at": "2026-08-25T22:05:59.357Z" }