Skip to documentation content
HintadataDocs

Product search

Resolve names, models, aliases, and EANs to product identifiers.

In this guide
  1. 1Search by name, model, alias, or EAN
  2. 2Interpret ranked results
  3. 3Design for no-result cases
In this guide
  1. 1Search by name, model, alias, or EAN
  2. 2Interpret ranked results
  3. 3Design for no-result cases

Search by name, model, alias, or EAN

bash
curl --fail-with-body "https://api.pricecompare.nordicdevhouse.com/v1/search?q=sony%20xm5" \
  -H "Authorization: Bearer $HINTADATA_API_KEY"

The q parameter accepts 1–120 characters. Prefer a model number or EAN when available, then use the returned name and specifications to confirm the correct variant.

Interpret ranked results

Read total and items, but do not assume the first result is always correct. Compare identifiers, brand, model, and specifications before saving the canonical product identifier.

Design for no-result cases

Offer a refined query or a review queue when no suitable match exists. Record the original query so catalogue coverage can be improved without silently selecting a wrong product.

Was this page helpful?
Product search – Docs | Hintadata