Quickstart
First successful call in minutes — every step below runs from this page.
Create your account and key
One email, one code. Then create a named API key — and every example on this page fills in with your key. Keys don't expire; revoke one whenever you're done with it.
Sign in or create an account takes about a minute
Make your first call
A capped sample of real catalog rows, deterministic on purpose so you can assert against it.
curl "https://api.stylumia.com/v1/sample?category=power_tools" \
-H "Authorization: Bearer $STYLUMIA_KEY" # Never commit your key — see /docs/key-security
Check meta.resolved in the response — the server echoes every parameter it actually used, including defaults you omitted.
Break it on purpose
Guess a category instead of discovering it. The error is the point: retryable tells you not to retry, recovery tells you what to do, and valid_options hands you real values — click one to re-run the fixed call.
That loop — fail, read the body, fix, succeed — is what a client does unattended, straight from the response body.
See what exists before you pull it
One call tells you how much data matches your filters, per retailer, category and department. Build it visually in the Explorer, or by hand:
/v1/coverage
/v1/coverage?retailer=home_depot