Search Tutorial

Performing a search on SHOP.COM is easy.  Using a standard browser you can enter in the following URL:

/sites/v1/search/Term/Socks

The response of this request is a JSON payload describing the products found for your search term.  Contained within this response are links to the JSON representation of products found on SHOP.COM.  By simply following these links you can see the data for the product right there in your browser.

productDetail

{

rel: "Pearl Izumi 2015 Men's Elite Low Wool Cycling/Running Socks - 14151422"

href: "/stores/v1/products/1042089218?siteId=260"

type: "application/json; charset=UTF-8"

}

 

So if we following the link provided above you can see see the product information below.

/stores/v1/products/1042089218?siteId=260

 

{
    "doNotUse": false,
    "flags": {
        "trendEnabled": true,
        "listEnabled": true,
        "egiftEnabled": true,
        "priceAlertEnabled": true,
        "giftRegistryEnabled": true,
        "saveForLaterEnabled": true,
        "eligibleForFreeShipping": false,
        "autoShipEnabled": false
    },
    "categoryInfo": {
        "productCategoryId": 32838,
        "categoryId": 2141095,
        "department": "Clothes",
        "category": "Socks & Hosiery",
        "productType": "Athletic Socks"
    },
    "priceInfo": {
        "price": "$14.00",
        "minimumUnits": 0,
        "isOnSaleMin": false,
        "isOnSaleMax": false,
        "hasMinMaxPricing": false,
        "customProduct": false,
        "localeId": 0,
        "showUpto": false,
        "cashBack": "$0.56",
        "distributorCashback": "$0.56",
        "ibv": "0.84",
        "upToCashBack": false
    },
    "currency": "$",
    "price": 14.00,
    "originalPrice": 14.00,
    "cashBack": {
        "prodId": 1042089218,
        "price": null,
        "cashBack": 0.56,
        "distributorCashBack": 0.56,
        "ciPoints": 0.0,
        "cashBackString": "$0.56",
        "distributorCashBackString": "$0.56",
        "ibvstring": "0.84",
        "bv": 0.0,
        "ibv": 0.84
    },
    "latency": 4,
    "optionData": {
        "prodId": 1042089218,
        "options": [40797206,
        40797207],
        "optionMap": {
            "40797206": {
                "optionGroupId": 0,
                "optionId": 40797206,
                "sortOrder": 1,
                "controlType": 2,
                "prompt": "Color:",
                "type": 2,
                "price": 0.00,
                "values": ["Black",
                "Shadow Grey"],
                "optionTypeId": 0,
                "typeName": "Color",
                "maxLength": 0
            },
            "40797207": {
                "optionGroupId": 0,
                "optionId": 40797207,
                "sortOrder": 2,
                "controlType": 2,
                "prompt": "Size:",
                "type": 1,
                "price": 0.00,
                "values": ["M",
                "L",
                "XL"],
                "optionTypeId": 0,
                "typeName": "Size",
                "maxLength": 0
            }
        },
        "hasPermutationData": true,
        "permutationData": {
            "currentPermutationId": 89471964,
            "permutationKey": "Black,M",
            "permutationValueKey": "Black,M",
            "permutationIndexKey": "40797206-0,40797207-0",
            "permutationKeyTemplate": "{40797206},{40797207}",
            "currentPermutationCashBack": {
                "prodId": 1042089218,
                "permutationId": 89471964,
                "currency": "$",
                "price": 14.00,
                "cashBack": 0.56,
                "distributorCashBack": 0.56,
                "ciPoints": 0.0,
                "cashBackString": "$0.56",
                "distributorCashBackString": "$0.56",
                "ibvstring": "0.84",
                "bv": 0.0,
                "ibv": 0.84
            },
            "adjacentPermutations": {
                "89471964": {
                    "permutationId": 89471964,
                    "permutationString": "Black,M",
                    "merchantSKU": "77088_406036",
                    "quantity": 95,
                    "price": 14.00,
                    "originalPrice": 14.00,
                    "inventoryStatus": 0,
                    "upcCode": "703051200084",
                    "distributorPrice": null
                },
                "89471961": {
                    "permutationId": 89471961,
                    "permutationString": "Shadow Grey,M",
                    "merchantSKU": "77088_406039",
                    "quantity": 95,
                    "price": 14.00,
                    "originalPrice": 14.00,
                    "inventoryStatus": 0,
                    "upcCode": "703051207687",
                    "distributorPrice": null
                },
                "89471960": {
                    "permutationId": 89471960,
                    "permutationString": "Black,L",
                    "merchantSKU": "77088_406035",
                    "quantity": 95,
                    "price": 14.00,
                    "originalPrice": 14.00,
                    "inventoryStatus": 0,
                    "upcCode": "703051200077",
                    "distributorPrice": null
                },
                "89471963": {
                    "permutationId": 89471963,
                    "permutationString": "Black,XL",
                    "merchantSKU": "77088_406037",
                    "quantity": 95,
                    "price": 14.00,
                    "originalPrice": 14.00,
                    "inventoryStatus": 0,
                    "upcCode": "703051200091",
                    "distributorPrice": null
                }
            },
            "popUpData": {
                "40797206": [{
                    "optionIndex": 0,
                    "optionValue": "Black",
                    "permutationId": 89471964
                },
                {
                    "optionIndex": 1,
                    "optionValue": "Shadow Grey",
                    "permutationId": 89471961
                }],
                "40797207": [{
                    "optionIndex": 0,
                    "optionValue": "M",
                    "permutationId": 89471964
                },
                {
                    "optionIndex": 1,
                    "optionValue": "L",
                    "permutationId": 89471960
                },
                {
                    "optionIndex": 2,
                    "optionValue": "XL",
                    "permutationId": 89471963
                }]
            }
        }
    },
    "otherProdContainerProducts": [],
    "otherOPContainerProducts": [],
    "browseData": [{
        "rel": "Clothes",
        "href": "/Clothes-a.xhtml",
        "type": "text/html"
    },
    {
        "rel": "Socks & Hosiery",
        "href": "/Clothes/Socks+~+Hosiery-3",
        "type": "text/html"
    },
    {
        "rel": "Athletic Socks",
        "href": "/Clothes/Socks+~+Hosiery-Socks+~+Hosiery+Type-Athletic+Socks-34",
        "type": "text/html"
    }],
    "extendedDescriptions": [],
    "reviewData": {
        "count": 0,
        "rating": 0
    },
    "similarItems": {
        "rel": "Similar Items",
        "href": "/Store/Product/SimilarItems/1074397417?siteId=260",
        "type": "application/json; charset=UTF-8"
    },
    "powerReviewData": {
        "prGroupID": 10445,
        "prSiteID": 1,
        "prLocale": "en_US",
        "prodPageID": "846003159",
        "cssLocation": "http://edge1.shop.com/ccimg.shop.com/pwr-test/css/prshop0423.css"
    },
    "storeSiteLink": {
        "rel": "BikeSomeWhere.com",
        "href": "/BikeSomeWhere+com-v249525-c+.xhtml",
        "type": "text/html"
    },
    "productLink": {
        "rel": "Product page",
        "href": "/Pearl+Izumi+2014+15+Mens+Elite+Low+Wool+Cycling+Running+Socks+14151422-1074397417-p+.xhtml",
        "type": "text/html"
    },
    "description": "Men's ELITE Low Wool socks combine the great benefits of medium weight Merino Wool with the excellent fit of our ELITE Series socks in a low cuff height. 51% nylon 46% Merino wool 3% LYCRA(R).<ul><li>ELITE Transfer Merino wool yarns provide superior moisture transfer and insulation<li>Flat toe seam construction provides superior comfort over toes<li>Anatomic arch compression for a performance fit<li>Mesh ventilation over top of foot<li>Low cuff height</ul>",
    "prodContainerID": 1074397417,
    "storeName": "BikeSomeWhere.com",
    "onSale": false,
    "opcontainerID": 846003159,
    "linkOff": false,
    "macatalog": false,
    "prodID": 1042089218,
    "sku": "77088_0_0",
    "caption": "Pearl Izumi 2014/15 Men's Elite Low Wool Cycling/Running Socks - 14151422",
    "oneCart": true,
    "brand": "Pearl Izumi",
    "imageURL": "http://edge.shop.com/ccimg.shop.com/240000/249500/249525/products/1074397417.jpg",
    "productType": "ONE",
    "weight": 0.13,
    "statusID": 0,
    "storeWWWLink": "",
    "storeLocaleID": 1,
    "imageWidth": 300,
    "imageHeight": 300,
    "merchantDescription": "Pearl Izumi 2014/15 Men's Elite Low Wool Cycling/Running Socks - 14151422",
    "productReviews": {
        "rel": "Product Reviews",
        "href": "/Store/Product/Reviews/1042089218?siteId=260",
        "type": "application/json; charset=UTF-8"
    },
    "departmentName": "Clothing/Socks",
    "sponsoredLinkTerm": "Pearl Izumi 2014/15 Men's Elite Low Wool Cycling/Running Socks - 14151422",
    "alternateImages": [{
        "url": "http://edge.shop.com/ccimg.shop.com/240000/249500/249525/products/lg_1074397417.jpg",
        "fileName": "lg_1074397417.jpg",
        "height": 1200,
        "width": 1200,
        "displayText": "View Larger Image",
        "sortOrder": 0,
        "alternateImageID": 258508851,
        "isLargeView": true
    }],
    "storeDescription": "BikeSomeWhere.com",
    "storeLogoImageFileName": "http://edge.shop.com/ccimg.shop.com/topbrands/nmlogos_102234.gif"
}