Use the REST API to Get Looks
To access data about product looks created via Shop The Look, you can use our REST API. This interface provides a structured method for retrieving detailed information about the product looks.
API Access
Our API uses bearer token for authentication.
You can generate API tokens directly from the app:
- Navigate to Settings in your Shop The Look dashboard
- Scroll to the "API Access" section
- Click "Generate New Token"
- Copy and securely store the token (it will only be shown once)
API tokens follow the format: stl_ followed by a unique identifier.
Get Product Look Data
This endpoint will give all the data needed to show a product look based on a main product ID.
GET https://shopify.shopthelook.app/api/v1/shop/product-look?mainProductId=shopifyProductId
The mainProductId argument is the Shopify ID for main product of the look created with Shop The Look.
shopifyProductId: use the product id from Shopify in this format: 343380066339
Sample Request: Response:
curl --location --request GET 'https://shopify.shopthelook.app/api/v1/shop/product-look?mainProductId=343380066339' --header 'Authorization: Bearer YOUR_API_TOKEN_HERE'
{
"items": [
{
"id": 343380066339,
"title": "Business Jacket",
"image": "https://cdn.shopify.com/s/files/1/2502/6434/products/2015-02-15_Addis_Look_13_30276_4258_390x.jpg?v=1509367383",
"variants": [
{
"id": "gid://shopify/ProductVariant/4516638392355",
"title": "48 / Cool Grey",
"price": "677.60",
"formattedPrice": "$677.60"
},
{
"id": "gid://shopify/ProductVariant/4516638425123",
"title": "50 / Cool Grey",
"price": "677.60",
"formattedPrice": "$677.60"
},
{
"id": "gid://shopify/ProductVariant/4516638457891",
"title": "52 / Cool Grey",
"price": "677.60",
"formattedPrice": "$677.60"
},
{
"id": "gid://shopify/ProductVariant/4516638490659",
"title": "54 / Cool Grey",
"price": "677.60",
"formattedPrice": "$677.60"
}
]
}
]
}
Get Product Looks Related Items IDs
If you're interested only in getting the related items for a Shopify Product ID that were set inside Shop The Look, you can use the following endpoint:
POST Request
https://shopify.shopthelook.app/api/v1/shop/product-look/related-items
Body Request:
{
"productLookMainIds": ["8207170437413", "8876116345125"]
}