Attraction Product API
Bring public Attraction product data into your catalog, product search, or assistant workflow.
Quick start
Run this request from a terminal to fetch public product summaries.
curl "https://api.attraction.com/v1/products?locale=en-US"List products
Fetch product summaries for catalogs, listing pages, search, filters, and color exploration.
Public request
curl "https://api.attraction.com/v1/products?locale=en-US"{
"locale": "en-US",
"products": [
{
"sku": "100386U",
"slug": "100386u",
"productName": "Crewneck T-shirt",
"descriptions": {
"tagline": "Crewneck t-shirt, our best-selling t-shirt. Ethica made in Canada.",
"short": "Crewneck t-shirt in jersey in organic cotton and recycled polyester, or 100% organic cotton depending on the colour, our best-selling t-shirt, wide colour range. Ethica made in Canada."
},
"brand": "Ethica",
"customization": {
"colorBlocks": false
},
"catalog": {
"inspiration": ["Promotional"],
"category": "T-shirts",
"for": "Unisex"
},
"keywords": ["t shirt","custom t shirt","crewneck","ethica","made in canada"],
"tag": "Best seller",
"minimumOrder": {
"quantity": 36,
"description": "Minimum 36 decorated units. No minimum undecorated."
},
"studio": {
"available": true
},
"pricing": {
"currency": "CAD",
"msrp": [
{ "minQuantity": 1, "maxQuantity": 23, "regularPrice": 30.5, "price": 30.5 },
{ "minQuantity": 24, "maxQuantity": 99, "regularPrice": 28, "price": 28 },
...
]
},
"images": [
{
"url": "https://www.attraction.com/assets/products/100386u/100386u-primary.webp",
"alt": "White Ethica crewneck T-shirt"
},
...
],
"colors": [
{
"id": "0001",
"pms": "White",
"name": "White",
"swatches": ["#FFFFFF"],
"colorFamilies": [
{
"name": "White",
"hex": "#F8F8F2"
}
],
"images": [
"https://www.attraction.com/assets/products/100386u/100386u-white.webp"
]
},
...
],
...
},
...
],
"categories": [
{
"name": "T-shirts",
"order": 10
},
...
],
"brands": {
"Ethica": {
"name": "Ethica",
"url": "https://www.attraction.com/en-us/products/ethica/",
"description": "Timeless classics, made in Canada with sustainable fibres."
},
...
}
}Get product details
Fetch one product for a product page, catalog sync, inventory check, asset lookup, or decoration compatibility lookup.
Public request
Fetch product detail, MSRP pricing, inventory, color metadata, materials, media, resource links, and compatible decoration methods without authentication.
curl "https://api.attraction.com/v1/products/100386U?locale=en-US"{
"sku": "100386U",
"slug": "100386u",
"locale": "en-US",
"productName": "Crewneck T-shirt",
"descriptions": {
"tagline": "Crewneck t-shirt, our best-selling t-shirt. Ethica made in Canada.",
"short": "Crewneck t-shirt in jersey in organic cotton and recycled polyester, or 100% organic cotton depending on the colour, our best-selling t-shirt, wide colour range. Ethica made in Canada.",
"long": "Crewneck t-shirt. Fabric: jersey in organic cotton and recycled polyester, or 100% organic cotton depending on the colour. Key features: our best-selling t-shirt, wide colour range."
},
"keywords": ["t shirt","custom t shirt","crewneck","ethica","made in canada"],
"note": "For women, order a smaller size than usual (M=S), since this is a unisex style.",
"brand": {
"name": "Ethica",
"url": "https://www.attraction.com/en-us/products/ethica/",
"description": "Timeless classics, made in Canada with sustainable fibres."
},
"insufficientInventoryMessage": "Insufficient inventory for your project? Ethica styles can usually be produced quickly. Contact us and we'll confirm lead times.",
"catalog": {
"inspiration": ["Promotional"],
"category": "T-shirts",
"for": "Unisex"
},
"links": {
"studio": "https://studio.jameo.com/home?lang=en"
},
"tag": "Best seller",
"materials": [
{
"code": "JERSEY",
"label": "Jersey"
}
],
"minimumOrder": {
"quantity": 36,
"description": "Minimum 36 decorated units. No minimum undecorated."
},
"customization": {
"colorBlocks": false,
"decorations": [
{
"name": "Digital Print (DTG)",
"note": "",
"icon": "https://www.attraction.com/assets/icons/digital-printing.svg",
"link": "https://www.attraction.com/en-us/decoration/#digital-printing"
}
]
},
"studio": {
"available": true
},
"pricing": {
"currency": "CAD",
"msrp": [
{ "minQuantity": 1, "maxQuantity": 23, "regularPrice": 30.5, "price": 30.5 },
{ "minQuantity": 24, "maxQuantity": 99, "regularPrice": 28, "price": 28 },
...
]
},
"images": [
{
"url": "https://www.attraction.com/assets/products/100386u/100386u-primary.webp",
"alt": "White Ethica crewneck T-shirt"
},
...
],
"assets": {
"images": [
{
"url": "https://www.attraction.com/assets/products/100386u/100386u-primary.webp",
"alt": "White Ethica crewneck T-shirt"
},
...
],
"resources": [
{
"type": "sizeChart",
"label": "Size chart",
"url": "https://www.attraction.com/assets/products/100386u/100386u.pdf"
},
...
]
},
"colors": [
{
"id": "0001",
"pms": "White",
"name": "White",
"weight": "7.4 oz/linear yd (150 gsm)",
"swatches": ["#FFFFFF"],
"colorFamilies": [
{
"name": "White",
"hex": "#F8F8F2"
}
],
"images": [
"https://www.attraction.com/assets/products/100386u/100386u-white.webp"
]
},
...
],
"inventory": [
{ "colorId": "0001", "size": "XS", "quantity": 124 },
...
]
}Net pricing through the API
Public endpoints return product content, MSRP pricing, inventory, color metadata, media, resources, and product-detail decorations. Authenticated API access for account-specific net pricing is coming later.
Error responses
Errors use the same status, code, and message fields. Missing authentication does not error because product data is public.
unsupported_locale
400 when locale is not one of en-CA, en-US, or fr-CA.
{
"status": 400,
"code": "unsupported_locale",
"message": "Supported locales are en-CA, en-US, and fr-CA."
}product_not_found
404 for /v1/products/{sku} when the SKU does not exist.
{
"status": 404,
"code": "product_not_found",
"message": "Product not found."
}rate_limited
429 when the request exceeds the v1 rate limit.
{
"status": 429,
"code": "rate_limited",
"message": "Too many requests. Please retry later."
}