Product Search and Detail With One Endpoint

Use the /products endpoint for search and product detail.

This endpoint follows the design of

https://api.shop.com/AffiliatePublisherNetwork/v1/products/{productId}
or
https://api.shop.com/AffiliatePublisherNetwork/v1/products/?{filters}

Product Detail
This example retrieves the product details for the 100oz Tide Laundry Detergent:
https://api.shop.com/AffiliatePublisherNetwork/v1/products/942783647?publisherID=TEST&locale=en_US

Product Search
This example retrieves all product summaries for the brand Tide that do NOT have the term “Detergent” (these products will be fresheners, filters, etc.):
https://api.shop.com/AffiliatePublisherNetwork/v1/products?publisherID=TEST&locale=en_US&perPage=15&term=-Detergent&brandId=Tide

Responses

The Product Search response will have the following attributes for each product in the result set:
https://api.shop.com/AffiliatePublisherNetwork/v1/products?publisherID=TEST&locale=en_US&perPage=15&term=opc3

….
{
"name": "Isotonix OPC-3®",
"minimumPrice": "$31.95",
"maximumPrice": "$71.95",
"brand": "Isotonix®",
"description": "Isotonix OPC-3 is one of the most revolutionary nutritional supplements available today. Between its unparalleled formula, including the clinically-studied ingredient Pycnogenol, and the revolutionary Isotonix Delivery System, there isn't a more...",
"imageUrl": "http://edge.shop.com/ccimg.shop.com/210000/214100/214196/products/561800349.jpg",
"id": 603139941,
"referralUrl": "http://www.shop.com/561800349-p.xhtml?publisherID=TEST",
"links": [
{
"rel": "details",
"href": "https://api.shop.com/AffiliatePublisherNetwork/v1/products/603139941?publisherID=TEST&locale=en_US",
"type": "application/json"
},
{
"rel": "referralPage",
"href": "http://www.shop.com/561800349-p.xhtml?publisherID=TEST",
"type": "text/html"
}
]
}
….

The Product Detail response will have these product attributes in the response:
https://api.shop.com/AffiliatePublisherNetwork/v1/products/603139941?publisherID=TEST&locale=en_US

{
"name": "Isotonix OPC-3®",
"maximumPrice": "$71.95",
"minimumPrice": "$31.95",
"id": 603139941,
"brand": "Isotonix®",
"shortDescription": "Isotonix OPC-3 is one of the most revolutionary nutritional supplements available today. Between its unparalleled formula, including the clinically-studied ingredient Pycnogenol, and the revolutionary Isotonix Delivery System, there isn't a more...",
"description": "Product BrochureIsotonix OPC-3 is one of the most revolutionary nutritional supplements available today. Between its unparalleled formula, including the clinically-studied ingredient Pycnogenol, and the revolutionary Isotonix Delivery System, there isn't a more effective antioxidant supplement on the market today. Isotonix OPC-3's list of benefits is substantial. From promoting your cardiovascular health by helping you maintain healthy blood vessels and showing anti-inflammatory activity, Isotonix OPC-3 provides complete antioxidant protection thanks to its unique formula. The power behind this advanced nutritional supplement powder comes from its formula of OPCs, or oligomeric proanthocyanidins: complex organic plant compounds called bioflavonoids that provide exceptional nutritional benefits to the human body, including antioxidant protection. Isotonix OPC-3 includes a combination of powerful bioflavonoids that protect against free radicals. This includes Pycnogenol, a super-antioxidant that is one of the most clinically-researched ingredients in the nutritional supplements industry. Many nutritional supplements - including other nutritional supplement powders - claim Pycnogenol as an ingredient, but only Isotonix products - including Isotonix OPC-3 - have exclusive worldwide rights to the isotonic form of the super-antioxidant Pycnogenol. The isotonic form of a nutrient - the defining characteristic of Isotonix nutritional supplements - is of vital importance. Traditional tablets and capsules can take hours for the body to digest; Isotonix nutritional supplements digest more quickly and are distributed throughout the body faster than pills. ",
"cashBack": 1.44,
"distributorCashBack": 1.44,
"ciPoints": 0,
"bv": 43.5,
"ibv": 0,
"freeShipping": true,
"catalogName": "Market America",
"catalogDescription": "Product BrochureIsotonix OPC-3 is one of the most revolutionary nutritional supplements available today. Between its unparalleled formula, including the clinically-studied ingredient Pycnogenol, and the revolutionary Isotonix Delivery System, there isn't a more effective antioxidant supplement on the market today. Isotonix OPC-3's list of benefits is substantial. From promoting your cardiovascular health by helping you maintain healthy blood vessels and showing anti-inflammatory activity, Isotonix OPC-3 provides complete antioxidant protection thanks to its unique formula. The power behind this advanced nutritional supplement powder comes from its formula of OPCs, or oligomeric proanthocyanidins: complex organic plant compounds called bioflavonoids that provide exceptional nutritional benefits to the human body, including antioxidant protection. Isotonix OPC-3 includes a combination of powerful bioflavonoids that protect against free radicals. This includes Pycnogenol, a super-antioxidant that is one of the most clinically-researched ingredients in the nutritional supplements industry. Many nutritional supplements - including other nutritional supplement powders - claim Pycnogenol as an ingredient, but only Isotonix products - including Isotonix OPC-3 - have exclusive worldwide rights to the isotonic form of the super-antioxidant Pycnogenol. The isotonic form of a nutrient - the defining characteristic of Isotonix nutritional supplements - is of vital importance. Traditional tablets and capsules can take hours for the body to digest; Isotonix nutritional supplements digest more quickly and are distributed throughout the body faster than pills. ",
"catalogLogoImageFileName": "http://edge.shop.com/ccimg.shop.com/topbrands/nmlogos_72094.gif",
"imageURL": "http://edge.shop.com/ccimg.shop.com/210000/214100/214196/products/561800349.jpg",
"referralUrl": "http://www.shop.com/561800349-p.xhtml?publisherID=TEST",
"autoShip": true,
"onSale": false,
"disclaimer": "*These statements have not been evaluated by the Food and Drug Administration. This product(s) is not intended to diagnose, treat, cure or prevent any disease.",
"category": {
"id": 0,
"name": "Health & Nutrition"
},
"reviewData": {
"count": "616",
"rating": 4
},
"links": [
{
"rel": "referralPage",
"href": "http://www.shop.com/561800349-p.xhtml?publisherID=TEST",
"type": "text/html"
}
]
}