Back to all updates

almost 10 years ago

The SHOP.COM APN API Histograms

Each "search" call with our /products endpoint will return the paginated result set of product summary data.  The result set also includes Histograms to help you further exlpore and drill into the data set.

The four Histograms offered are:

Category (with a count of products for each category)

Brand (with a count of products for each brand)

Seller (with a count of products for each Vendor that sells one or more of the products on SHOP.COM)

Price Range (with a count of products, distributed as evenly as possible across price ranges)

Here is the Histogram provided when doing a search for the term "laundry":

Call-

https://api.shop.com/AffiliatePublisherNetwork/v1/products?publisherID=TEST&locale=en_US&perPage=15&term=laundry

Histogram included in result set:

....

"categories": [
{
"name": "Home Store",
"productCount": 5595,
"id": "1-32842"
},
{
"name": "Tools",
"productCount": 436,
"id": "1-32843"
},
{
"name": "Shoes",
"productCount": 388,
"id": "1-32805"
},
{
"name": "Clothes",
"productCount": 462,
"id": "1-32838"
},
{
"name": "Sports Fan Shop",
"productCount": 415,
"id": "1-32877"
},
{
"name": "Garden",
"productCount": 45,
"id": "1-32808"
},
{
"name": "Business",
"productCount": 97,
"id": "1-32820"
},
{
"name": "Beauty",
"productCount": 54,
"id": "1-32867"
},
{
"name": "Posters",
"productCount": 257,
"id": "1-32807"
},
{
"name": "Crafts",
"productCount": 84,
"id": "1-32835"
},
{
"name": "Health & Nutrition",
"productCount": 56,
"id": "1-32841"
},
{
"name": "Travel",
"productCount": 46,
"id": "1-32813"
},
{
"name": "Toys",
"productCount": 19,
"id": "1-32810"
},
{
"name": "Sports and Fitness",
"productCount": 24,
"id": "1-32844"
},
{
"name": "Food and Drink",
"productCount": 10,
"id": "1-32806"
},
{
"name": "Baby",
"productCount": 13,
"id": "1-32811"
},
{
"name": "Pet Supplies",
"productCount": 11,
"id": "1-32809"
},
{
"name": "Electronics",
"productCount": 4,
"id": "1-32863"
},
{
"name": "Party Supplies",
"productCount": 3,
"id": "1-32840"
},
{
"name": "Computers",
"productCount": 2,
"id": "1-32862"
}
],
"brands": [
{
"name": "Honey Can Do",
"productCount": 486,
"id": "\"Honey Can Do\""
},
{
"name": "Colonial Mills",
"productCount": 415,
"id": "\"Colonial Mills\""
},
{
"name": "Chinese Laundry",
"productCount": 227,
"id": "\"Chinese Laundry\""
},
{
"name": "Platinum",
"productCount": 304,
"id": "Platinum"
},
{
"name": "SNAP™",
"productCount": 5,
"id": "SNAP™"
},
{
"name": "Tide",
"productCount": 112,
"id": "Tide"
},
{
"name": "Bulk Buys",
"productCount": 233,
"id": "\"Bulk Buys\""
},
{
"name": "Redmon",
"productCount": 103,
"id": "Redmon"
},
{
"name": "Rubbermaid",
"productCount": 83,
"id": "Rubbermaid"
},
{
"name": "Arm & Hammer",
"productCount": 19,
"id": "\"Arm & Hammer\""
},
{
"name": "Household Essential",
"productCount": 101,
"id": "\"Household Essential\""
},
{
"name": "Procter & Gamble",
"productCount": 64,
"id": "\"Procter & Gamble\""
},
{
"name": "Clorox",
"productCount": 30,
"id": "Clorox"
},
{
"name": "Meyers",
"productCount": 94,
"id": "Meyers"
},
{
"name": "Dickies",
"productCount": 84,
"id": "Dickies"
},
{
"name": "Sterilite",
"productCount": 28,
"id": "Sterilite"
},
{
"name": "Dirty Laundry",
"productCount": 54,
"id": "\"Dirty Laundry\""
},
{
"name": "Downy",
"productCount": 18,
"id": "Downy"
},
{
"name": "Seventh Generation",
"productCount": 32,
"id": "\"Seventh Generation\""
},
{
"name": "3M",
"productCount": 21,
"id": "3M"
}
],
"sellers": [
{
"name": "UnbeatableSale",
"productCount": 4965,
"id": "104162"
},
{
"name": "SpectrumSuperStore",
"productCount": 635,
"id": "101549"
},
{
"name": "Zoro",
"productCount": 420,
"id": "108908"
},
{
"name": "Shoe Metro",
"productCount": 371,
"id": "102510"
},
{
"name": "Farm & City Supply",
"productCount": 370,
"id": "108100"
},
{
"name": "Farm & Home Supply Center",
"productCount": 301,
"id": "101557"
},
{
"name": "Hipp Modern Builders Supply",
"productCount": 280,
"id": "110657"
},
{
"name": "SHOP.COM Direct Office Supplies",
"productCount": 274,
"id": "102193"
},
{
"name": "Drill Spot",
"productCount": 239,
"id": "107363"
},
{
"name": "Posterazzi.com",
"productCount": 212,
"id": "102567"
},
{
"name": "SHOPfreely.com",
"productCount": 196,
"id": "101383"
},
{
"name": "SHOP.COM MarketPlace",
"productCount": 181,
"id": "105534"
},
{
"name": "pcRUSH",
"productCount": 141,
"id": "102511"
},
{
"name": "ChampionsOnDisplay.com",
"productCount": 134,
"id": "102272"
},
{
"name": "Limited Goods",
"productCount": 126,
"id": "109164"
},
{
"name": "Stuff4",
"productCount": 108,
"id": "102501"
},
{
"name": "Cymax Store",
"productCount": 98,
"id": "105582"
},
{
"name": "SportShopDirect",
"productCount": 84,
"id": "102975"
},
{
"name": "Alliance Supply ",
"productCount": 82,
"id": "103248"
},
{
"name": "SHOP.COM Groceries",
"productCount": 75,
"id": "105204"
}
],
"priceRanges": [
{
"minPrice": 0,
"maxPrice": 20,
"productCount": 3078,
"id": "[0.0 TO 20.00]"
},
{
"minPrice": 20.01,
"maxPrice": 35,
"productCount": 2516,
"id": "[20.01 TO 35.00]"
},
{
"minPrice": 35.01,
"maxPrice": 55,
"productCount": 2027,
"id": "[35.01 TO 55.00]"
},
{
"minPrice": 55.01,
"maxPrice": 100,
"productCount": 2080,
"id": "[55.01 TO 100.00]"
},
{
"minPrice": 100.01,
"maxPrice": 1912.87,
"productCount": 1933,
"id": "[100.01 TO 1912.87]"
}
]
}