Skip to main content

Get related products (bulk)

GET 
/search/relations/bulk-results

Retrieve relation results for multiple product identifiers at once.

⚠️ At least one of includeRelations or includeTags must be provided. Omitting both returns a 400 Bad Request error. You may send both.

Request​

Responses​

OK

{
    "424357": {
        "tags": [
            {
                "tag": "Compatible",
                "relations": [
                    {
                        "name": "Matching Accessories",
                        "id": 4728,
                        "localization": {
                            "names": []
                        },
                        "searchResult": [
                            [
                                {
                                    "identifier": "PRD-9876-BLU40",
                                    "groupId": "9876",
                                    "sxId": 240538699,
                                    "dataPoints": [
                                        {
                                            "id": 281559600,
                                            "conceptIdName": "CATEGORY",
                                            "key": "Category",
                                            "type": "PASS_ON",
                                            "value": "Cases",
                                            "isCategory": true
                                        }
                                    ],
                                    "image": "www.myshop.com/product/9876-blu40/img.jpg",
                                    "name": "Laptop Case 9876 Blue",
                                    "images": [
                                        {
                                            "type": "ALTERNATIVE",
                                            "url": "www.myshop.com/product/9876-blu40/img.jpg"
                                        }
                                    ],
                                    "link": "www.myshop.com/product/9876-blu40",
                                    "head": false,
                                    "relevance": 1000000
                                }
                            ]
                        ]
                    }
                ]
            }
        ]
    },
    "484365": {
        "tags": [
            {
                "tag": "Compatible",
                "relations": [
                    {
                        "name": "Matching Accessories",
                        "id": 4728,
                        "localization": {
                            "names": []
                        },
                        "searchResult": [
                            [
                                {
                                    "identifier": "PRD-5432-SLV20",
                                    "groupId": "5432",
                                    "sxId": 240538701,
                                    "dataPoints": [
                                        {
                                            "id": 281559600,
                                            "conceptIdName": "CATEGORY",
                                            "key": "Category",
                                            "type": "PASS_ON",
                                            "value": "Cases",
                                            "isCategory": true
                                        }
                                    ],
                                    "image": "www.myshop.com/product/5432-slv20/img.jpg",
                                    "name": "Laptop Case 5432 Silver",
                                    "images": [
                                        {
                                            "type": "ALTERNATIVE",
                                            "url": "www.myshop.com/product/5432-slv20/img.jpg"
                                        }
                                    ],
                                    "link": "www.myshop.com/product/5432-slv20",
                                    "head": false,
                                    "relevance": 999999
                                }
                            ]
                        ]
                    }
                ]
            }
        ]
    }
}