Create a sandbox key
Open the developer dashboard, select the test environment and create an API key with catalog:read. Keep the key on your server. Test keys return representative demo data; live keys require an imported source snapshot.
Search products
bashillustrative
Example trust: illustrativeShows the shape or idea; do not use it unchanged in production.
curl --fail-with-body "https://hintadata.fi/v1/search?q=sony&limit=10" \
-H "Authorization: Bearer $HINTADATA_API_KEY"Read items and next_offset in the JSON response. X-Data-Mode identifies demo or live data; X-Data-Observed-At retains the source observation time. A 503 source_unavailable means live evidence has not been imported.