The canonical record of every product on earth.

1. UC-01 · Facets

   Filters that return everything.

   The failure. A filter only works when every product answers its question. Every missing value hides a sellable product from a willing buyer, and the report never shows it.

   The record. Type profiles make core attributes required and coverage public. Buckets derive from the type's real quantiles, not from guesswork; incomplete values are excluded, never guessed.

   Facet · optical.light_output : iso_21118coverage 98%

   10,000 to 12,000 lm38

   12,000 to 16,000 lm21

   bucket_strategy: type_quantiles59 of 59 qualifying products shown
2. UC-02 · Retrieval

   Search that finds what shoppers mean.

   The failure. Shoppers and shopping agents ask in plain language. Catalog search matches strings; the sale goes to whichever shop matches meaning.

   The record. One endpoint fuses lexical, semantic, and structured retrieval, parses intent into constraints, and reports how it read the query. Agents get the same answer through the same canon.

   GET /v1/searchInterpreted · constraints_applied: 5

   "quiet 4k laser projector for daylight rooms"

   type = installation_projectoranchor

   lightsource.technology = lasereq

   optical.resolution ≥ 4k uhdgte

   acoustic.noise_level ≤ percentile:50 → 37 dBlte

   optical.light_output ≥ percentile:75 · iso_21118gte

   prefer=measuredSynonyms mapped, not guessed
3. UC-03 · Product pages

   Product pages worth reading.

   The failure. A product page with nine spec rows, no manual, and no compliance block is a dead end for the shopper, a blind spot for support, and a liability under GPSR.

   The record. One dossier carries the full page: attributes in the type's presentation order, documents and assets on file, the regulatory container, and context sentences ready to render.

   Dossier · gpd:family:sharp.a155uCompleteness 0.91

   presentation groups: optics → connectivity → acousticsTyped order

   datasheet_pdf · manual · bim_revit · iesOn file

   declaration_of_conformity · energy label · GPSR responsible personRegulatory

   "Quieter than 78% of its class."Context, evidence-backed

   Compliance fields: manufacturer and regulatory sources only
4. UC-04 · Rendering

   The record, rendered in your brand.

   The failure. Eight markets means eight translations, one tone of voice to hold, and product images from nine suppliers' studios on one shelf.

   The record. Facts are language-free; rendering is configurable. Locale paints labels, units, and prose in your tone profile; image profiles unify supplier imagery to your style. The canonical values never move underneath.

   Generated prose is stamped with model and prompt version; it renders facts and is never a source of them.

   Rendering · locale=de-DE · units=regionalFacts stay canonical

   Lichtleistung · 15.000 lm (gemessen: 14.280 lm)

   Tone precise retail editorial

   Images studio neutral in situ technical line

   Originals kept on file · one style across every supplier

$ curl https://api.getproductdata.com/v1/resolve \
    -H "Authorization: Bearer gpd_live_51Hx…" \
    -d gtin=4012345678901

{
  "object":     "resolution",
  "verdict":    "exact_variant",
  "confidence": 0.99,
  "variant":    "gpd:variant:sharp.a155u.white",
  "family":     "gpd:family:sharp.a155u"
}

$ curl ".../v1/products/gpd:family:sharp.a155u?depth=full&expand=claims,context"

"optical.light_output": {
  "statements": [
    { "value": 15000, "unit": "lm", "epistemic": "claimed",  "confidence": 0.97 },
    { "value": 14280, "unit": "lm", "epistemic": "measured", "reality_delta_pct": -4.8 }
  ]
},
"context": { "percentiles": { "optical.light_output": 0.91, "acoustic.noise_level": 0.22 } },
"quality": { "completeness_vs_type_profile": 0.91, "overall_confidence": 0.89 }

$ curl -G .../v1/search \
    --data-urlencode "type=gpd:type:installation_projector" \
    --data-urlencode "filter[optical.light_output:iso_21118][gte]=10000" \
    --data-urlencode "filter[acoustic.noise_level][lte]=percentile:50" \
    --data-urlencode "prefer=measured"

"interpreted": { "notes": ["percentile:50 resolved to 37 dB for this type"] }

Qualifier pinning is enforced. A brightness filter without its measurement standard returns 400 qualifier_required instead of silently lying to you.

Both statements stand, each with its sources; the delta is part of the record. Claimed and measured never merge into one flattering number.

1. 01

   Resolve

   Identity first. Candidates are scored, never forced; ambiguity is a verdict, and every merge is reversible with its reasoning on file.

2. 02

   Research

   Manufacturer sources first, then labs, retailers, registries. Every finding lands as a claim: source, locator, content hash, retrieval date.

3. 03

   Adjudicate

   Sources earn reputation weekly. A datasheet outranks a shop page; on measured values, the lab outranks both. Contested is a respectable verdict.

4. 04

   Publish

   412 statements, 2 conflicts open, both visible in the payload. A 0.7-complete dossier with provenance beats no dossier.

Scan under 5 minutes · standard under 30 · deep under 4 hours · a created job always reaches a terminal state