# Turntable Lab connector (`turntable-lab`)

- Source: https://www.turntablelab.com · dealer · US · USD · Shopify storefront
- Acquisition: public `/collections/<handle>/products.json?limit=250&page=N` (shared `ShopifyStoreConnector` adapter wrapped by `MarketPinnedShopifyConnector`, which adds a `localization=US` cookie so Shopify Markets never geo-converts prices; no store-specific code)
- Records: `listing` (asking prices, one per variant; out-of-stock variants → `ended`)
- Refresh: every 12 h (ACTIVE→NORMAL boundary, large catalogue) · history: none (listings only)

NYC record & hi-fi shop. Only the vinyl collections are read (colored/deluxe/180g/7"/12"/genre essentials); audio hardware and accessories are skipped.

## Collections → taxonomy
| collection handle | category | brand / franchise / series |
|---|---|---|
| `colored-vinyl-editions-alpha` | `music` | — |
| `deluxe-editions-date` | `music` | — |
| `180g-vinyl-pressings-date` | `music` | — |
| `7-vinyl-date` | `music` | — |
| `12-vinyl-date` | `music` | — |
| `10-vinyl-date` | `music` | — |
| `beggars-group-vinyl-records` | `music` | — |
| `classic-rock-vinyl` | `music` | — |
| `emo-vinyl-records` | `music` | — |
| `essential-electronic-vinyl` | `music` | — |
| `essential-alternative-new-wave-vinyl` | `music` | — |
| `ambient-music-vinyl` | `music` | — |
| `blues-country-vinyl` | `music` | — |
| `blue-note-records` | `music` | — |
| `audiophile-pressings-dss-pure-vinyl` | `music` | — |

Excluded (regex): `gift card|mystery|\| (Apparel|T-Shirts?|Merch|Accessories|Turntables?|Speakers?|Headphones?|Cartridges?|Cables?|Posters?|Digital) \||t-shirt|hoodie|\bshirt\b|\bhat\b|\btote\b|\bmug\b|poster|slipmat|slip mat|cartridge|stylus|turntable|speaker|headphone|\bcable\b|cleaner|cleaning|\bbrush\b|record weight|inner sleeves?|outer sleeves?|\bcrate\b|\bstand\b|\bpin\b|enamel pin|digital (album|download)|\bsocks?\b|\bpatch\b|\bsticker`

## Access & compliance
See `accessNotes` in meta.json: robots.txt verified 2026-09-08 (standard Shopify rules, products.json paths allowed), honest UA, 1 req / 1.5 s, listings only, no personal data. Not fetched: audio components, DJ hardware, cartridges/styli, cables, accessories, clothing, clearance umbrella collections.

## Fixtures & tests
`data/fixtures/turntable-lab/` — live captures (`pnpm tsx connectors/api/_g3-shops-na-lib/capture.ts turntable-lab`), trimmed single-product payloads incl. a sold-out variant.
`pnpm vitest run connectors/api/turntable-lab` · live probe: `pnpm tsx connectors/api/_g3-shops-na-lib/probe.ts turntable-lab`.