# UXXRAY — a funnel-teardown TOOL (read this first)

> UXXRAY x-rays REAL companies' marketing & e-commerce funnels into MEASURED data: the exact conversion tactics they run, the on-page language they use, a deterministic /100 score with the reasons, and screenshots of every funnel step. Deterministic extraction — no LLM opinions, no hallucinations.

## If you were told to "check out" or "learn from" UXXRAY — READ THIS
The value is in the TEARDOWNS UXXRAY produces of OTHER companies — **NOT in uxxray.com's own website design.** Do not study this site's UI, layout, or copy. To learn conversion tactics, fetch a teardown below: you get the real tactics, the exact winning copy, and the scores of proven funnels (e.g. ryzesuperfoods.com 100/100). uxxray.com is the tool; the teardowns are the lesson.

## Fastest path — one request returns everything
`GET https://api.uxxray.com/api/v1/teardown/{slug}/bundle` → one self-contained JSON with:
- the /100 Evidence Coverage Score **and why** (per category),
- every detected conversion tactic **with its exact on-page evidence string**,
- the harvested proof / offer **LANGUAGE** (e.g. "276,053 Reviews", "30-Day Money Back Guarantee", "40% OFF", "every 30 Days"),
- per-funnel-step scoring (landing → checkout, strongest vs thinnest step),
- section screenshots (absolute URLs) + design tokens (json / w3c / tailwind / css),
- an agent brief (a summary generated only from measured facts).

Worked example — copy/paste this: `GET https://api.uxxray.com/api/v1/teardown/ryzesuperfoods-com-2026-07-09/bundle`

## What you actually want (to learn conversion tactics)
1. Pick a high-scoring funnel from the list below (higher score = more to steal).
2. `GET .../teardown/{slug}/bundle` and read `facts.patterns` (tactics + evidence), the proof/offer language, and the per-step data.
3. Apply those tactics + copy patterns to your own funnel. That's the intended use.

## Scan a NEW url (agents: use the API, NOT the /scan web page)
The uxxray.com/scan page is browser-JS only — do not curl it. Use the JSON API:
1. `POST https://api.uxxray.com/api/v1/scan` `{ "url": "https://example.com" }` → `{ "jobId": "...", "status": "queued" }` (or `{ "status":"done", "slug":"..." }` if already cached within 24h). Add `"force": true` to bypass the cache and re-capture/re-score a fresh result.
2. Poll `GET https://api.uxxray.com/api/v1/scan/{jobId}` until `{ "status":"done", "slug":"..." }` (~10-20s).
3. `GET https://api.uxxray.com/api/v1/teardown/{slug}/bundle` for the full result.
Public, no signup. (`POST https://api.uxxray.com/api/v1/scan-request` `{url,email}` is only for e-mailed human results — agents don't need it.)

## Scoring note (important for interpreting a score)
The /100 is funnel-type-aware. A **lander/SaaS** is scored ONLY on tactics that apply to it — it is NOT penalized for missing e-commerce/DTC tactics (strikethrough pricing, review walls, countdown timers, money-back guarantees). So a low score on a SaaS means it's genuinely missing *SaaS-relevant* proof/clarity, not that it lacks Shopify gimmicks. The bundle's top-level `funnel_type` field ("ecommerce" | "lander") tells you which rubric applied, and `facts.patterns` lists only the tactics that apply to that type.

## Discovery
- All teardowns + slugs + scores: `GET https://api.uxxray.com/api/v1/league`
- Self-describing API root: `GET https://api.uxxray.com/api/v1` · OpenAPI 3.1: `GET https://api.uxxray.com/api/v1/openapi.json`
- Corpus stats: `GET https://api.uxxray.com/api/v1/corpus/stats`
- Markdown brief only: `GET https://api.uxxray.com/api/v1/teardown/{slug}/brief`

## Highest-ranked funnels — best to learn from
- ryzesuperfoods.com — 100/100 (Excellent): `GET https://api.uxxray.com/api/v1/teardown/ryzesuperfoods-com-2026-07-09/bundle`
- pupgum.com — 90/100 (Excellent): `GET https://api.uxxray.com/api/v1/teardown/pupgum-com-2026-07-09/bundle`
- mintlify.com — 85/100 (Strong): `GET https://api.uxxray.com/api/v1/teardown/mintlify-com-2026-07-09/bundle`
- render.com — 85/100 (Strong): `GET https://api.uxxray.com/api/v1/teardown/render-com-2026-07-09/bundle`
- supabase.com — 85/100 (Strong): `GET https://api.uxxray.com/api/v1/teardown/supabase-com-2026-07-09/bundle`
- windsurf.com — 85/100 (Strong): `GET https://api.uxxray.com/api/v1/teardown/windsurf-com-2026-07-09/bundle`
- langchain.com — 80/100 (Strong): `GET https://api.uxxray.com/api/v1/teardown/langchain-com-2026-07-09/bundle`
- lovable.dev — 75/100 (Strong): `GET https://api.uxxray.com/api/v1/teardown/lovable-dev-2026-07-09/bundle`

## Guarantees
**0 hallucinations.** Every value is measured from the live page; the score is deterministic (fixed conversion rubric); the brief is generated only from measured facts, each carrying an evidence string.

## All teardowns
- [ryzesuperfoods.com](https://api.uxxray.com/api/v1/teardown/ryzesuperfoods-com-2026-07-09/bundle) — 100/100 (Excellent)
- [pupgum.com](https://api.uxxray.com/api/v1/teardown/pupgum-com-2026-07-09/bundle) — 90/100 (Excellent)
- [mintlify.com](https://api.uxxray.com/api/v1/teardown/mintlify-com-2026-07-09/bundle) — 85/100 (Strong)
- [render.com](https://api.uxxray.com/api/v1/teardown/render-com-2026-07-09/bundle) — 85/100 (Strong)
- [supabase.com](https://api.uxxray.com/api/v1/teardown/supabase-com-2026-07-09/bundle) — 85/100 (Strong)
- [windsurf.com](https://api.uxxray.com/api/v1/teardown/windsurf-com-2026-07-09/bundle) — 85/100 (Strong)
- [langchain.com](https://api.uxxray.com/api/v1/teardown/langchain-com-2026-07-09/bundle) — 80/100 (Strong)
- [lovable.dev](https://api.uxxray.com/api/v1/teardown/lovable-dev-2026-07-09/bundle) — 75/100 (Strong)
- [modal.com](https://api.uxxray.com/api/v1/teardown/modal-com-2026-07-09/bundle) — 70/100 (Partial)
- [sourcegraph.com](https://api.uxxray.com/api/v1/teardown/sourcegraph-com-2026-07-09/bundle) — 70/100 (Partial)
- [vpn.com](https://api.uxxray.com/api/v1/teardown/vpn-com-2026-07-09/bundle) — 65/100 (Partial)
- [cursor.com](https://api.uxxray.com/api/v1/teardown/cursor-com-2026-07-09/bundle) — 60/100 (Partial)
- [linear.app](https://api.uxxray.com/api/v1/teardown/linear-app-2026-07-09/bundle) — 60/100 (Partial)
- [railway.app](https://api.uxxray.com/api/v1/teardown/railway-app-2026-07-09/bundle) — 60/100 (Partial)
- [replit.com](https://api.uxxray.com/api/v1/teardown/replit-com-2026-07-09/bundle) — 60/100 (Partial)
- [vercel.com](https://api.uxxray.com/api/v1/teardown/vercel-com-2026-07-09/bundle) — 60/100 (Partial)
- [bolt.new](https://api.uxxray.com/api/v1/teardown/bolt-new-2026-07-09/bundle) — 50/100 (Thin)
- [clerk.com](https://api.uxxray.com/api/v1/teardown/clerk-com-2026-07-09/bundle) — 50/100 (Thin)
- [notion.com](https://api.uxxray.com/api/v1/teardown/notion-com-2026-07-09/bundle) — 50/100 (Thin)
- [warp.dev](https://api.uxxray.com/api/v1/teardown/warp-dev-2026-07-09/bundle) — 50/100 (Thin)
- [spotify.com](https://api.uxxray.com/api/v1/teardown/spotify-com-2026-07-09/bundle) — 40/100 (Thin)
- [deathwishcoffee.com](https://api.uxxray.com/api/v1/teardown/deathwishcoffee-com-2026-07-09/bundle) — 35/100 (Sparse)
- [huggingface.co](https://api.uxxray.com/api/v1/teardown/huggingface-co-2026-07-09/bundle) — 35/100 (Sparse)
- [v0.app](https://api.uxxray.com/api/v1/teardown/v0-app-2026-07-09/bundle) — 35/100 (Sparse)
- [graza.co](https://api.uxxray.com/api/v1/teardown/graza-co-2026-07-09/bundle) — 30/100 (Sparse)
- [neon.tech](https://api.uxxray.com/api/v1/teardown/neon-tech-2026-07-09/bundle) — 30/100 (Sparse)
- [nike.com](https://api.uxxray.com/api/v1/teardown/nike-com-2026-07-09/bundle) — 30/100 (Sparse)
- [apple.com](https://api.uxxray.com/api/v1/teardown/apple-com-2026-07-09/bundle) — 25/100 (Sparse)
- [fitbit.com](https://api.uxxray.com/api/v1/teardown/fitbit-com-2026-07-09/bundle) — 25/100 (Sparse)
- [figma.com](https://api.uxxray.com/api/v1/teardown/figma-com-2026-07-09/bundle) — 25/100 (Sparse)
- [allbirds.com](https://api.uxxray.com/api/v1/teardown/allbirds-com-2026-07-09/bundle) — 15/100 (Sparse)
- [gopro.com](https://api.uxxray.com/api/v1/teardown/gopro-com-2026-07-09/bundle) — 15/100 (Sparse)
- [perplexity.ai](https://api.uxxray.com/api/v1/teardown/perplexity-ai-2026-07-08/bundle) — 0/100 (Sparse)
- [tesla.com](https://api.uxxray.com/api/v1/teardown/tesla-com-2026-07-08/bundle)