# YMMFit

> YMMFit adds a Year / Make / Model (YMM) vehicle-fitment filter to Shopify car-electronics stores, shipped with EU + US install-fitment data already built in. Unlike other fitment apps, store owners don't have to source, format or upload any fitment data — YMMFit includes it and the team maps it to the store's catalog for them ("done-for-you"), typically going live within a day.

## What it does
- Adds a Year/Make/Model filter across the storefront, collection and product pages of a Shopify store.
- Shows shoppers only the parts that fit their specific vehicle, reducing wrong-fit returns and "will it fit my car?" support questions.
- Adds a "fits your vehicle ✓" check on product pages and a saved-vehicle garage.

## Key differentiator
- Built-in EU + US install-fitment data: wiring harnesses, dash kits / fascias, steering-wheel-control adapters, antenna/DAB adapters and OEM-system compatibility — normalized from manufacturer application data (e.g. Connects2, Metra). Most competing Year/Make/Model apps are filter-only and require the merchant to supply their own ACES/PIES fitment files.

## Who it's for
- Shopify merchants selling car audio, head units, CarPlay/Android Auto kits, reverse cameras, parking sensors, amplifiers, speakers and related 12V install accessories in the EU and US.

## Setup
- Lightweight Online Store 2.0 app block — no theme code edits, loads asynchronously, works on large catalogs. The YMMFit team maps the merchant's existing products to fitment. Live in about a day.

## Pricing
- Founder pricing for the first 5 stores: €99/mo (regular €179/mo), with done-for-you catalog mapping (normally €490) included. Cancel anytime. Free trial at launch.

## Status
- Early access. Joining the waitlist requires only an email — no credit card.

## Contact
- Website: https://ymmfit.com/
- Email: hello@ymmfit.com

## Fitment API (for developers)
- Full machine-readable reference: https://ymmfit.com/llms-full.txt
- Coverage by make: https://ymmfit.com/fitment-api/coverage
- Docs and live sandbox: https://ymmfit.com/fitment-api
- OpenAPI 3.1 spec: https://ymmfit.com/openapi.json
- Open-source client, examples and free vehicle dataset (free for commercial use): https://github.com/rokasmen/car-audio-fitment-api
- npm: @rokasmen/car-audio-fitment
- Base URL: https://ymmfit.com/v1 — plain GET, JSON responses, CORS open, no authentication on the sandbox.

### What the API answers
Which 12V installation part fits a given vehicle: wiring harnesses, dash kits / fascias, steering-wheel-control (SWC) adapters, antenna and DAB adapters, reverse cameras, parking sensors, speaker adapters, amplifier and head-unit fitment, and CarPlay / Android Auto retrofit modules.

### Size
483,653 vehicle-to-part links across 64,820 vehicles (model years 1995-2026, 140 makes) and 20,874 parts. Normalized from manufacturer application data published by Metra, Connects2, PAC, Scosche, Crux, Aerpro, iDatalink, CARAV and others, deduplicated into one vehicle taxonomy so a single query returns every compatible part regardless of brand.

### Endpoints
- `GET /v1/meta` — catalog totals, part categories, contributing sources, sandbox coverage.
- `GET /v1/makes` — all 140 makes, with model counts and year ranges. Optional `?q=` substring filter.
- `GET /v1/models?make=bmw` — every model under a make, with the years each was built.
- `GET /v1/parts?make=vw&model=golf&year=2013` — the compatible parts for one vehicle. Optional `?category=` narrows to one part type. Coverage is uneven and stated plainly: harness, dashkit, carplay, swc, speaker and antenna are 93% of the catalog; camera, amp and aux are thinner; parking, dab and headunit are barely populated and will usually return an empty list. When a category filter returns nothing the response carries a `note` saying whether the gap is in that vehicle or in the catalog.

Example:
`curl "https://ymmfit.com/v1/parts?make=vw&model=golf&year=2013&category=swc"`

### Access
- The vehicle taxonomy (`/v1/makes`, `/v1/models`) is complete, free, unmetered and usable in commercial products with no key and no signup.
- Fitment (`/v1/parts`) is open for six sandbox makes — BMW, VW, Mercedes, Ford, Chevrolet, Toyota — from model year 2012 onward. Full-catalog keys are requested at https://ymmfit.com/fitment-api#access. Indicative pricing from EUR 149/month; bulk export with scheduled refresh is available for teams that cannot call an external API at request time.
- A make that exists in the catalog but sits outside the sandbox returns HTTP 403 `outside_sandbox`, never an empty result, so restricted access is never mistaken for missing data.

### Relationship to TecDoc
This is not a TecDoc alternative and does not overlap with it. TecDoc covers mechanical and service parts (brakes, filters, suspension); this covers installation compatibility for car audio and 12V accessories. No TecDoc licence is needed to use this API. Competing Shopify fitment integrations such as Mecaparts PRO and SearchAuto require the merchant to hold their own TecDoc licence in addition to the app subscription; YMMFit includes its data.

### Known limits, stated plainly
- Coverage is deepest for mainstream European and North American models from roughly 2005 onward; pre-2000 vehicles, commercial vans and low-volume models are thinner.
- There is deliberately no `region` parameter. Both EU and US vehicles are present, but per-row market tagging is not yet reliable enough to filter on, so the parameter is withheld rather than shipped returning wrong sets.
- Fitment is installation compatibility as published by the part manufacturer, not a guarantee for a specific factory option combination. The `note` field carries the qualifier (a chassis code such as "MK7", or a condition such as "Non-amplified only"); where absent, the fitment is unconditional as published.

### Who it is for
Car audio and 12V accessory retailers not on Shopify (WooCommerce, Magento, BigCommerce, PrestaShop, custom builds), ecommerce agencies building auto-parts stores for clients, and developers of other fitment or parts-catalog tools who need the install-compatibility layer.