Using our REST API For Getting 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'll need to request an API token from our support chat or via an email to contact@shopthelookapp.com

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 https://shopify.shopthelook.app/api/v1/shop/product-look/related-items

Body Request:

{
    "productLookMainIds": ["8207170437413", "8876116345125"]
}

For the response, you'll get each of the sent mainProductId as the index with an array for related product Shopify IDs.

Response Example:

{
"8207170437413": [
   "8876123783461",
   "8207170437413"
],
"8876116345125": [
   "8207170437413"
]
}