Yahoo! Shopping Search API Filtering

API returns filters which can be used to refine a search. Let's start with a search and see the available filters.

API Examples

Example with p: Table

Example with p: Table

JSON Example

{
  "filters": [
    {
      "key": "gender",
      "values": [
        {
          "id": "gender_female",
          "name": "female"
        },
        {
          "id": "gender_male",
          "name": "male"
        }
      ]
    },
    {
      "key": "age",
      "values": [
        {
          "id": "age_adult",
          "name": "adult"
        },
        {
          "id": "age_kid",
          "name": "kid"
        }
      ]
    },
    {
      "key": "stores",
      "values": [
        {
          "id": "3cf3c2e4-90aa-4398-a970-83eb69413f9b",
          "name": "Wayfair"
        }
      ]
    },
    {
      "key": "categories",
      "values": [
        {
          "id": "436",
          "name": "Furniture"
        },
        {
          "id": "536",
          "name": "Home & Garden"
        },
        {
          "id": "922",
          "name": "Office Supplies"
       },
       ...
      ]
    }
  ],
  ...
}

Example with p:hat, and category_attr_values:gender_female

API returns filters which can be used to refine a search. Let's start with a search for hat and than use filter by category_attr_values (Gender or age) in the next search below.

Example with p:hat, and category_attr_values:gender_female

JSON Example

{
  "shopping_results": [
    {
      "position": 1,
      "product_id": "skimlinks_49657-792193819",
      "link": "https://shopping.yahoo.com/product/skimlinks_49657-792193819",
      "title": "Woman's Hat Bowknot Design, Sun Hat, Summer Fashion Beach Small Brim Dress Hats",
      "seller": "Etsy",
      "price": 39.99,
      "thumbnail": "https://s.yimg.com/lo/api/res/1.2/xgmTmclmD1JQu._70hG.sQ--/YXBwaWQ9ZWNfaG9yaXpvbnRhbDtoPTQwMDtzcz0xO3c9NDAw/https://i.etsystatic.com/22760787/r/il/13db89/2329977277/il_fullxfull.2329977277_fgcs.jpg.cf.jpg"
    },
    {
      "position": 2,
      "product_id": "skimlinks_1034-57830804",
      "link": "https://shopping.yahoo.com/product/skimlinks_1034-57830804",
      "title": "Velvet Bucket Hat",
      "seller": "Urban Outfitters",
      "price": 24.0,
      "sale_price": 9.99,
      "thumbnail": "https://s.yimg.com/lo/api/res/1.2/1B6CM8ZJCjOmgsNFUtzL6A--/YXBwaWQ9ZWNfaG9yaXpvbnRhbDtoPTQwMDtzcz0xO3c9NDAw/https://images.urbanoutfitters.com/is/image/UrbanOutfitters/57830804_000_b?.cf.jpg"
    },
    {
      "position": 3,
      "product_id": "skimlinks_49657-862239493",
      "link": "https://shopping.yahoo.com/product/skimlinks_49657-862239493",
      "title": "Pawstar Nitemare Bunny Hat - Scarf Beanie Rabbit Nightmare Super Long Ear Fleece Striped Goth Emo Red Black White Pink Purple Gray 1520",
      "seller": "Etsy",
      "price": 32.3,
      "thumbnail": "https://s.yimg.com/lo/api/res/1.2/Rbtr4not_dwlikLPDgj3AQ--/YXBwaWQ9ZWNfaG9yaXpvbnRhbDtoPTQwMDtzcz0xO3c9NDAw/https://i.etsystatic.com/6609139/r/il/926ffb/2715613499/il_fullxfull.2715613499_n09d.jpg.cf.jpg"
    },
    ...
  ],
  "filters": [
    {
      "key": "gender",
      "values": [
        {
          "id": "gender_female",
          "name": "female"
        }
      ]
    },
    {
      "key": "age",
      "values": [
        {
          "id": "age_adult",
          "name": "adult"
        },
        {
          "id": "age_kid",
          "name": "kid"
        },
        {
          "id": "age_toddler",
          "name": "toddler"
        }
      ]
    },
    {
      "key": "stores",
      "values": [
        {
          "id": "234571dd-7d8f-42da-8239-408158d11f08",
          "name": "Etsy"
        },
        {
          "id": "06ab842e-8ad2-4d6b-8f25-6041d4384f3d",
          "name": "Overstock"
        },
        {
          "id": "31c61407-e887-4623-8aae-988aaab1aec1",
          "name": "thredUP"
        },
        ...
      ]
    },
    {
      "key": "categories",
      "values": [
        {
          "id": "166",
          "name": "Apparel & Accessories"
        },
        {
          "id": "536",
          "name": "Home & Garden"
        },
        {
          "id": "8",
          "name": "Arts & Entertainment"
        },
        ...
      ]
    }
  ],
  ...
}

Example with p:Tablemerchants:3cf3c2e4-90aa-4398-a970-83eb69413f9b

API returns filters which can be used to refine a search. Let's start with a search for table and than use filter by merchants in the next search below.

Example with p:Table, merchants:3cf3c2e4-90aa-4398-a970-83eb69413f9b

JSON Example

{
  "shopping_results": [
    {
      "position": 1,
      "product_id": "00196268671073",
      "link": "https://shopping.yahoo.com/product/00196268671073",
      "title": "Computer Desk Gaming Desk L Shaped Desk Office Writing Desk Modern Student Girl Kids Study PC Simple Extra Large Ergonomic Table Workstation,Vintage",
      "seller": "Wayfair",
      "price": 119.99,
      "thumbnail": "https://s.yimg.com/lo/api/res/1.2/TO3wWZDxTolGiU_MCwZSpg--/YXBwaWQ9ZWNfaG9yaXpvbnRhbDtoPTQwMDtzcz0xO3c9NDAw/https://secure.img1-fg.wfcdn.com/im/14419546/resize-h400-w400%5Ecompr-r85/1498/149809172/.jpg.cf.jpg"
    },
    {
      "position": 2,
      "product_id": "05045649012736",
      "link": "https://shopping.yahoo.com/product/05045649012736",
      "title": "Gold Flamingo Brennen 22' Table Lamp Metal/Fabric in Black/Brown, Size 22.0 H x 9.0 W x 9.0 D in | Wayfair 80F769D1AC6F484EBEA6D1C8981A8D53",
      "seller": "Wayfair",
      "price": 86.99,
      "thumbnail": "https://s.yimg.com/lo/api/res/1.2/NdCDDfSqpGS2JXvWFGgqbw--/YXBwaWQ9ZWNfaG9yaXpvbnRhbDtoPTQwMDtzcz0xO3c9NDAw/https://d6.cnnx.io/image/obj/10838347050;sq=400;p=0;t=ooPwmM0WTWKKBAJLVV1yc0coF-nUjhTDc6rXEFNDm46aEFCTzdA63MJAkIewkQxWsg1RX1_MQmMadwKc7FROp0VV_eK0T5m0FXiMe4bFSb9r5cziVLWtz3B8SE9Z.cf.jpg"
    },
    {
      "position": 3,
      "product_id": "connexity_12913094114",
      "link": "https://shopping.yahoo.com/product/connexity_12913094114",
      "title": "Topcraft Portable Poker Table Top w/ Carrying Bag Wood in Brown, Size 70.5 H x 35.5 W x 0.1 D in | Wayfair TY327042-A",
      "seller": "Wayfair",
      "price": 66.31,
      "thumbnail": "https://s.yimg.com/lo/api/res/1.2/IcMHp5d9fERcJ2.I61CmxQ--/YXBwaWQ9ZWNfaG9yaXpvbnRhbDtoPTQwMDtzcz0xO3c9NDAw/https://d10.cnnx.io/image/obj/12913094114;sq=400;p=0;t=ooPwmM0WTWKKBAJLVV1yc0coF-nUjhTDc6rXEFNDm46aEFCTxNU_0sFDlY6wkQxW65S4f3KsGTu5K7MhfOJTLGXHbuhGq-ttFck_Ujd2Q4vEfPnhmEa22ra5BLFY.cf.jpg"
    },
    ...
  ],
  "filters": [
    {
      "key": "gender",
      "values": [
        {
          "id": "gender_female",
          "name": "female"
        },
        {
          "id": "gender_male",
          "name": "male"
        }
      ]
    },
    {
      "key": "age",
      "values": [
        {
          "id": "age_adult",
          "name": "adult"
        },
        {
          "id": "age_kid",
          "name": "kid"
        }
      ]
    },
    {
      "key": "stores",
      "values": [
        {
          "id": "3cf3c2e4-90aa-4398-a970-83eb69413f9b",
          "name": "Wayfair"
        }
      ]
    },
    {
      "key": "categories",
      "values": [
        {
          "id": "436",
          "name": "Furniture"
        },
        {
          "id": "536",
          "name": "Home & Garden"
        },
        {
          "id": "922",
          "name": "Office Supplies"
        },
        ...
      ]
    }
  ],
  ...
}