Skip to main content
Build a catalog export with stable IDs that you can join in your own system. Parent Products are styles or product families. Product Options belong to a Parent Product. SKUs identify individual catalog variations and can reference a Product Option. These are three different resources. Before you start, obtain an API key, set AMBER_API_KEY and AMBER_BRAND, and save the shared Node.js client as amber-client.mjs. The script below requires Node.js 22 or later.
1

Inspect one page

The response’s items contains Parent Product summaries, including id, code, and name. Continue with nextCursor until it is null. To export selected products, use code for an exact product code or q for part of a name or code. Use the returned IDs in later requests. See Find records for examples.
2

Export the collections once per brand

Save this as export-catalog.mjs. Each output line is a JSON object with resource and record, so different resource shapes remain distinguishable.
export-catalog.mjs
The final file is replaced only when the script succeeds. Requests run sequentially and honor 429 responses through the shared client. An empty collection contributes no lines. A successful run can produce an empty file.
3

Join records using IDs

/options defines attributes; it does not return Product Options. Option-value definitions carry optionId, and dimension-value definitions carry dimensionId. Keep these library IDs to resolve labels.Assignment records may have no id. Key option prices by (productOptionId, kind, currency), option-value assignments by (productOptionId, optionValueId), and SKU dimensions by (skuId, dimensionValueId). Include brand and resource in your local keys.

Narrow the export to one Parent Product

Use a real Parent Product ID from step 1:
The same productId filter works on /skus and /product-option-prices. To retrieve one Product Option’s SKUs, use /skus?productOptionId={id}. Every filtered collection still needs pagination.

Add specifications or run on a schedule

The export contains the listed collections, not every field in a Parent Product detail. Use Read product specifications for custom fields, BOMs, versioned specifications, and measurement tables. For recurring jobs, follow the reconciliation guidance. Read-only access does not provide an import or update operation.