ShoppingAPI Public API v1

Canonical product data

This stable, read-only API is for machines. It does not use the website locale or return presentation labels as canonical fields.

Endpoints

• GET /api/v1 — API version and resource links.
• GET /api/v1/products — product list. Supports category, brand, q, limit, and offset.
• GET /api/v1/products/[canonical_key] — one canonical product with a key-to-value specifications object.
• GET /api/v1/products/[canonical_key]/offers — known public offers only.
• GET /api/v1/categories — canonical category keys.
• GET /api/v1/openapi.json — OpenAPI 3.1 contract.

Data rules

• Specification keys and values are canonical machine data; locale labels, formatted display values, and presentation group names are excluded.
• Missing specifications are omitted; they are never inferred.
• Price, stock, delivery, and availability are null when unknown, not estimated.
• Affiliate URLs are returned only when stored in the public source record. Raw source metadata and internal IDs are excluded.

Compatibility

The existing unversioned /api/* routes remain available for current consumers. New integrations should use /api/v1/*.