# Swervie

> Swervie is a product comparison catalog. It reads every listing of a
> product across retailers, collapses near-identical duplicates
> (including white-label products sold under different brands) into one
> consolidated listing, and ranks the members on quality and price. Each
> consolidated listing names one "best choice". Prices come from live
> seller offers.

Agents get the same answer humans see: already deduplicated, already
ranked. Every HTML page also embeds schema.org Product JSON-LD.

## Catalog API (JSON, no auth)

- /api/agent/categories: open categories with product and listing counts
- /api/agent/category/Televisions: Televisions (180 products, 2 consolidated listings)
- /api/agent/category/Headphones: Headphones (55 products, 0 consolidated listings)
- /api/agent/category/Hand%20Pruners: Hand Pruners (49 products, 5 consolidated listings)
- /api/agent/category/Men%E2%80%99s%20Deodorant: Men’s Deodorant (29 products, 0 consolidated listings)
- /api/agent/group/{id}: one consolidated listing with ranked members and best-choice offers
- /api/agent/product/{id}: one product with identifiers (GTIN/UPC/ASIN), specs, and live seller offers

## Reading the data

- price fields are integer USD cents (best_price_cents: 2499 = $24.99)
- swervie_score and value_score are 0-100, higher is better
- is_best_choice marks the recommended member of a consolidated listing
- match_confidence (0-1) is how sure the grouping is that members are interchangeable