Retailer Academy
Prepare a valid hardware product feed, understand validation and mapping results, and keep your store offers accurate after going live.
Get your catalogue ready for The Comparator
Prepare a valid hardware product feed, understand validation and mapping results, and keep your offers accurate after they go live.
Start with feed preparation ยท Submit partner application
1. Before you start
To successfully list your store offers on The Comparator, ensure you have:
- A product catalogue of PC components (GPU, CPU, SSD, RAM, Motherboards)
- Stable product identifiers (GTIN, MPN, or internal SKU)
- Direct product page URLs accessible without login
- Transparent, machine-readable prices in USD
- A dedicated technical contact for feed mapping questions
2. The Onboarding Path
Our onboarding is an assisted technical process:
[1. Prepare] โ [2. Submit] โ [3. Validate] โ [4. Match] โ [5. Go Live] โ [6. Maintain]
- Prepare: Format your product data according to our Feed Preparation Guide.
- Submit: Provide your feed URL via the Partner Application Form.
- Validate: Our pipeline tests schema validity, price formats, and URL reachability.
- Match: Offers are matched against our hardware reference database (
ref_specs.json). - Go Live: Matched offers are published to comparison tables (e.g., “Where to Buy” blocks).
- Maintain: Automatic daily fetches update prices and stock availability.
3. Onboarding Interfaces

4. Available Documentation Guides
- ๐ Prepare your product feed: Complete reference on required fields (
id,title,price,gtin,mpn), title formatting rules, and troubleshooting errors. - ๐ ๏ธ Manage your feed and mapping results: Guide to reading CSV Mapping Reports, resolving
Ambiguousitems, and submitting corrections.
5. Quick Downloads & Resources
- ๐ Download Sample CSV Feed
- ๐ Download Sample JSON Feed
- ๐ Download Sample Google Merchant XML Feed
Validate your sample files locally:
node scripts/test_sample_feeds.js
6. Current Product Capabilities
- Active Market: United States (USD) only.
- Supported Categories: GPU, CPU, SSD, RAM, Motherboards.
- Unsupported Items: Component bundles (CPU+Mobo combos), PC cases, coolers, and pre-built systems are automatically rejected by our
isComboListingingest filter. - Integration Model: Assisted onboarding (our team configures data mapping).
- Organic Value Engine: Value Scores and ranking are 100% algorithmic and independent of commercial store agreements.