API Documentation

This service is in BETA. For access please Fill out the application

CONTENTS
RESOURCES
MACROS
VERBS
REPORTS
RESEARCH API

ModernMWS by SellerLabs

Overview

ModernMWS is a RESTful API for quickly and reliably aggregating data from various endpoints of Amazon Marketplace Web Services (MWS) and Amazon Product Advertising API (PAAPI). Using ModernMWS, you can get information about:

  • Products matching a keyword or product id
  • Projected fees to be charged from Amazon for specific item sales
  • Offer listings for items
  • Categories that products fall under
  • and more!

Endpoints

  • GET /v1/offers/:ASIN
  • GET /v1/lookup
  • GET /v1/search
  • GET /v1/item/:ASIN
  • GET /v1/fees/:ASIN
  • GET /v1/itemLookup/:ASIN
  • GET /v1/getAsinCategories/:ASIN
  • GET /v1/getCategoryById/:CategoryId

Authentication

All ModernMws endpoints require user authentication. Once you have a ClientId and SecretKey, a request can be signed in the following way:

  • Get the current epoch time in seconds, call this Timestamp
    • time() in PHP
    • Date.now() in javascript
  • concatenate Timestamp, ClientId and SecretKey and get an md5 hash of the result (call this Hash)
  • The Key of a request is a pipe (|) -delimeted concatenation of Timestamp, ClientId and Hash, in that order.

The request Key must be embedded in one of two places in every ModernMws endpoint call:

  1. As a query parameter in the URL labeled key, i.e. ?key=KEY
  2. In the Authorization header of your request (with no bearer)

Authentication Example

  • ClientId = SellerLabsTest
  • SecretKey = MySecretIsSafeHere
  • Timestamp = 1428820769

  • Take md5 of SellerLabsTestMySecretIsSafeHere1428820769

    • Hash = 905698307795307c32b4f520953c70b5
  • Concatenate ClientId, SecretKey and Timestamp with pipes
    • Key = 1428820769|SellerLabsTest|905698307795307c32b4f520953c70b5

/v1/offers/:ASIN

Description

Aggregates data from the following Amazon endpoints and merges them into a single response:

  • MWS GetLowestOfferListingsForASIN (with Condition=Used)
  • MWS GetLowestOfferListingsForASIN (with Condition=New)
  • MWS GetCompetitivePricingForASIN
  • MWS GetMatchingProductForID
  • PAAPI ItemLookup

This endpoint is used to collect a wealth of information about a single ASIN, including all offers for the product at the current time and various statistics. The pretty format is suggested.

Sample Request

Request Parameters
Parameter Values Description
format (optional) pretty, bettermws_json, bettermws_sphp Formatting style for the response
nopaapi (optional) true, false Set to true to omit the ItemLookup call (faster)
http://research.api.sellerlabs.com/v1/offers/B0001BMXJ4?format=pretty

Sample Response (Pretty Format)

{
  "offers": {
    "fbaUsed": [],
    "merchantUsed": [
      {
        "cond": "Used",
        "subcond": "Mint",
        "fc": "Merchant",
        "shipdom": "Unknown",
        "shipmax": "0-2 days",
        "rating": "90-94%",
        "number": 1,
        "fbcount": 217,
        "multi": "False",
        "price": 9.9,
        "priceShipping": 0,
        "priceLanded": 9.9
      }
    ],
    "fbaNew": [
      {
        "cond": "New",
        "subcond": "New",
        "fc": "Amazon",
        "shipdom": "True",
        "shipmax": "0-2 days",
        "rating": "98-100%",
        "number": 2,
        "fbcount": 199238,
        "multi": "True",
        "price": 9.99,
        "priceShipping": 0,
        "priceLanded": 9.99
      },
      {
        "cond": "New",
        "subcond": "New",
        "fc": "Amazon",
        "shipdom": "True",
        "shipmax": "0-2 days",
        "rating": "90-94%",
        "number": 1,
        "fbcount": 289,
        "multi": "False",
        "price": 10.61,
        "priceShipping": 0,
        "priceLanded": 10.61
      }
    ],
    "merchantNew": [
      {
        "cond": "New",
        "subcond": "New",
        "fc": "Merchant",
        "shipdom": "True",
        "shipmax": "0-2 days",
        "rating": "80-89%",
        "number": 1,
        "fbcount": 20398,
        "multi": "False",
        "price": 13.84,
        "priceShipping": 0,
        "priceLanded": 13.84
      },
      {
        "cond": "New",
        "subcond": "New",
        "fc": "Merchant",
        "shipdom": "Unknown",
        "shipmax": "14 or more days",
        "rating": "98-100%",
        "number": 1,
        "fbcount": 2,
        "multi": "False",
        "price": 8.95,
        "priceShipping": 8.59,
        "priceLanded": 17.54
      }
    ]
  },
  "extras": {
    "newLowest": 9.99,
    "newCount": 5,
    "usedLowest": 9.9,
    "usedCount": 1,
    "msrp": 9.99,
    "salesrank": 4251,
    "azprice": 0,
    "tradeInPrice": null,
    "usedBuybox": 9.9,
    "newBuybox": 9.99,
    "ean": "0719812005904",
    "upc": "719812005904",
    "newLowestLanded": 9.99,
    "usedLowestLanded": 9.9,
    "megaseller": 9.99,
    "category": "Other",
    "totalFbaUsed": 0,
    "totalFbaNew": 3,
    "totalFba": 3,
    "totalMerchantUsed": 1,
    "totalMerchantNew": 2,
    "totalMerchant": 3
  },
  "id": "B0001BMXJ4",
  "timestamp": "2015-01-07T16:00:07.099Z",
  "requestId": "3ff878b0-9686-11e4-a494-fd94ef123401"
}

/v1/lookup

Description

This endpoint is exactly the same as /v1/offers, but uses the older "bettermws"-style authentication scheme instead of the newer Seller Labs Research API scheme.

/v1/search

Description

Searches Amazon for products using an ASIN, UPC, EAN or keyword. ASIN, UPC and EAN searches directly wrap the ListMatchingProducts endpoint of MWS, while keyword searches wrap the GetMatchingProductForId endpoint. The pretty format is preferred.

Sample Request

Request Parameters

Parameter Values Description
format (optional) pretty Formatting style for the response
asin Any valid ASIN The ASIN to search for
upc Any valid UPC The UPC to search for
ean Any valid EAN The EAN to search for
keyword A string representing the keyword to search for A keyword to search for

Only one of asin, upc, ean, keyword should be defined in a request, but one is required.

http://research.api.sellerlabs.com/v1/search?asin=B0001BMXJ4&format=pretty
http://research.api.sellerlabs.com/v1/search?keyword=spoon&format=pretty

Sample Response

ASIN Search:
{
    "searchCatalogs": {
        "result": [
            {
                "catalog": "amazon",
                "productId": "B0001BMXJ4",
                "title": "OXO Good Grips Brushed Stainless Steel Spoon",
                "image": "http://ecx.images-amazon.com/images/I/31Q449GT8QL._SL240_.jpg",
                "type": "Kitchen",
                "rank": {
                    "ProductCategoryId": "kitchen_display_on_website",
                    "Rank": 4251
                },
                "weight": 0.25,
                "ean": null
            }
        ]
    },
    "timestamp": "2015-01-07T16:17:41.572Z",
    "requestId": "b47c4840-9688-11e4-ba1a-b960e739b32f"
}
Keyword Search:
{
    "searchCatalogs": {
        "result": [
            {
                "catalog": "amazon",
                "productId": "B00KTZAL9G",
                "title": "They Want My Soul",
                "image": "http://ecx.images-amazon.com/images/I/4185LlRJ6YL._SL240_.jpg",
                "type": "Music",
                "rank": {
                    "ProductCategoryId": "music_display_on_website",
                    "Rank": 176
                },
                "weight": 0.16,
                "ean": null
            },
            {
                "catalog": "amazon",
                "productId": "B002GAY07Q",
                "title": "Nuby Hot Safe Feeding Spoons, 4-Count",
                "image": "http://ecx.images-amazon.com/images/I/41LWIaSEkKL._SL240_.jpg",
                "type": "Baby Product",
                "rank": {
                    "ProductCategoryId": "baby_product_display_on_website",
                    "Rank": 356
                },
                "weight": 0.05,
                "ean": null
            },
            {
                "catalog": "amazon",
                "productId": "B000LSL5ZK",
                "title": "Munchkin Soft-Tip Infant Spoon, 6 Count",
                "image": "http://ecx.images-amazon.com/images/I/41ORU-rDV-L._SL240_.jpg",
                "type": "Baby Product",
                "rank": {
                    "ProductCategoryId": "baby_product_display_on_website",
                    "Rank": 127
                },
                "weight": 0.25,
                "ean": null
            },
            {
                "catalog": "amazon",
                "productId": "B007LKFW7I",
                "title": "Gerber Graduates Rest Easy Spoons, 5-Count",
                "image": "http://ecx.images-amazon.com/images/I/51rl21mPCjL._SL240_.jpg",
                "type": "Baby Product",
                "rank": {
                    "ProductCategoryId": "baby_product_display_on_website",
                    "Rank": 498
                },
                "weight": 0.2,
                "ean": null
            },
            {
                "catalog": "amazon",
                "productId": "B000RGSOQO",
                "title": "Ga Ga Ga Ga Ga",
                "image": "http://ecx.images-amazon.com/images/I/61IPAfsjlIL._SL240_.jpg",
                "type": "Music",
                "rank": {
                    "ProductCategoryId": "music_display_on_website",
                    "Rank": 14204
                },
                "weight": 0.2,
                "ean": null
            },
            {
                "catalog": "amazon",
                "productId": "B00HZO5S4M",
                "title": "Munchkin White Hot Infant Safety Spoons, 4 Count",
                "image": "http://ecx.images-amazon.com/images/I/41z8ufRkjNL._SL240_.jpg",
                "type": "Baby Product",
                "rank": {
                    "ProductCategoryId": "baby_product_display_on_website",
                    "Rank": 173
                },
                "weight": 0,
                "ean": null
            },
            {
                "catalog": "amazon",
                "productId": "B004HMUIN6",
                "title": "Munchkin Silicone Spoons, Colors May Vary, 2 Count",
                "image": "http://ecx.images-amazon.com/images/I/31o7MJejRPL._SL240_.jpg",
                "type": "Baby Product",
                "rank": {
                    "ProductCategoryId": "baby_product_display_on_website",
                    "Rank": 221
                },
                "weight": 0,
                "ean": null
            },
            {
                "catalog": "amazon",
                "productId": "B008X6RH0E",
                "title": "Gerber Graduates Kiddy Cutlery Spoon Set, 3 Count",
                "image": "http://ecx.images-amazon.com/images/I/41mXJ1Uj4VL._SL240_.jpg",
                "type": "Baby Product",
                "rank": {
                    "ProductCategoryId": "baby_product_display_on_website",
                    "Rank": 7391
                },
                "weight": 0.25,
                "ean": null
            },
            {
                "catalog": "amazon",
                "productId": "B000056O2Q",
                "title": "Girls Can Tell",
                "image": "http://ecx.images-amazon.com/images/I/31YBHDZHMYL._SL240_.jpg",
                "type": "Music",
                "rank": {
                    "ProductCategoryId": "music_display_on_website",
                    "Rank": 6484
                },
                "weight": 0.22,
                "ean": null
            },
            {
                "catalog": "amazon",
                "productId": "B0038JDV4W",
                "title": "OXO Tot Fork and Spoon Set, Aqua",
                "image": "http://ecx.images-amazon.com/images/I/41XJIyf9YZL._SL240_.jpg",
                "type": "Baby Product",
                "rank": {
                    "ProductCategoryId": "baby_product_display_on_website",
                    "Rank": 235
                },
                "weight": 0.07,
                "ean": null
            }
        ]
    },
    "timestamp": "2015-01-07T16:18:47.396Z",
    "requestId": "dbb83a41-9688-11e4-ba1a-b960e739b32f"
}

/v1/item/:ASIN

Description

Exactly the same as /v1/search?asin=:ASIN; All of the same request parameters are allowed, this is just shorthand for the same thing.

/v1/fees/:ASIN

Description

Get the projected Amazon fees for a product offer based on an ASIN and a selling price for the object.

Sample Request

Request Parameters
Parameter Values Description
price <Number> Selling price for the item
http://research.api.sellerlabs.com/v1/fees/B0001BMXJ4?price=30

Sample Response

{
    "data": {
        "sizeTier": "large-standard",
        "mfnFees": {
            "price": 30,
            "revenue": 30,
            "azComm": 4.5,
            "azVar": 0,
            "feesTotal": 4.5,
            "netIncome": 25.5,
            "category": "Kitchen"
        },
        "fbaFees": {
            "price": 30,
            "revenue": 30,
            "azComm": 4.5,
            "azVar": 0,
            "fbaWeight": 0.46,
            "fbaPick": 1.02,
            "fbaOrder": 1,
            "feesTotal": 6.98,
            "netIncome": 23.02,
            "category": "Kitchen"
        }
    },
    "timestamp": "2015-01-07T17:50:39.357Z",
    "requestId": "b11abad1-9695-11e4-838d-a9b2a7ff70b5"
}

/v1/itemLookup/:ASIN

Description

Directly hit the ItemLookup endpoint of PAAPI for a given ASIN.

Sample Request

http://research.api.sellerlabs.com/v1/itemLookup/B0001BMXJ4

Sample Response

{
  "requestId": "6290fd80-968a-11e4-ba1a-b960e739b32f",
  "timestamp": "2015-01-07T16:29:43.128Z",
  "ItemLookupResponse": {
    "$": {
      "xmlns": "http://webservices.amazon.com/AWSECommerceService/2011-08-01"
    },
    "OperationRequest": {
      "RequestId": "ae9310d5-787d-4946-a2ef-694e9a78edb5",
      "Arguments": {
        "Argument": [
          {
            "$": {
              "Name": "Condition",
              "Value": "All"
            }
          },
          {
            "$": {
              "Name": "Operation",
              "Value": "ItemLookup"
            }
          },
          {
            "$": {
              "Name": "Service",
              "Value": "AWSECommerceService"
            }
          },
          {
            "$": {
              "Name": "Signature",
              "Value": "dTorFE/QlAHTbqyqpsSC0yHnNdSwJFFDbP3sl5XMTsk="
            }
          },
          {
            "$": {
              "Name": "AssociateTag",
              "Value": "foobar-20"
            }
          },
          {
            "$": {
              "Name": "SellerId",
              "Value": "Amazon"
            }
          },
          {
            "$": {
              "Name": "Version",
              "Value": "2011-08-01"
            }
          },
          {
            "$": {
              "Name": "ItemId",
              "Value": "B0001BMXJ4"
            }
          },
          {
            "$": {
              "Name": "IdType",
              "Value": "ASIN"
            }
          },
          {
            "$": {
              "Name": "AWSAccessKeyId",
              "Value": "1234567890abcdef12345"
            }
          },
          {
            "$": {
              "Name": "Timestamp",
              "Value": "2015-01-07T16:29:43.129Z"
            }
          },
          {
            "$": {
              "Name": "ResponseGroup",
              "Value": "OfferFull,Reviews,ItemAttributes"
            }
          }
        ]
      },
      "RequestProcessingTime": "0.0471810000000000"
    },
    "Items": {
      "Request": {
        "IsValid": "True",
        "ItemLookupRequest": {
          "Condition": "All",
          "IdType": "ASIN",
          "ItemId": "B0001BMXJ4",
          "ResponseGroup": [
            "OfferFull",
            "Reviews",
            "ItemAttributes"
          ],
          "VariationPage": "All"
        }
      },
      "Item": {
        "ASIN": "B0001BMXJ4",
        "ParentASIN": "B00F3T970C",
        "DetailPageURL": "http://www.amazon.com/OXO-Grips-Brushed-Stainless-Steel/dp/B0001BMXJ4%3Fpsc%3D1%26SubscriptionId%3D1234567890abcdef12345%26tag%3Dfoobar-20%26linkCode%3Dxm2%26camp%3D2025%26creative%3D165953%26creativeASIN%3DB0001BMXJ4",
        "ItemLinks": {
          "ItemLink": [
            {
              "Description": "Technical Details",
              "URL": "http://www.amazon.com/OXO-Grips-Brushed-Stainless-Steel/dp/tech-data/B0001BMXJ4%3FSubscriptionId%3D1234567890abcdef12345%26tag%3Dfoobar-20%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3DB0001BMXJ4"
            },
            {
              "Description": "Add To Baby Registry",
              "URL": "http://www.amazon.com/gp/registry/baby/add-item.html%3Fasin.0%3DB0001BMXJ4%26SubscriptionId%3D1234567890abcdef12345%26tag%3Dfoobar-20%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3DB0001BMXJ4"
            },
            {
              "Description": "Add To Wedding Registry",
              "URL": "http://www.amazon.com/gp/registry/wedding/add-item.html%3Fasin.0%3DB0001BMXJ4%26SubscriptionId%3D1234567890abcdef12345%26tag%3Dfoobar-20%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3DB0001BMXJ4"
            },
            {
              "Description": "Add To Wishlist",
              "URL": "http://www.amazon.com/gp/registry/wishlist/add-item.html%3Fasin.0%3DB0001BMXJ4%26SubscriptionId%3D1234567890abcdef12345%26tag%3Dfoobar-20%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3DB0001BMXJ4"
            },
            {
              "Description": "Tell A Friend",
              "URL": "http://www.amazon.com/gp/pdp/taf/B0001BMXJ4%3FSubscriptionId%3D1234567890abcdef12345%26tag%3Dfoobar-20%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3DB0001BMXJ4"
            },
            {
              "Description": "All Customer Reviews",
              "URL": "http://www.amazon.com/review/product/B0001BMXJ4%3FSubscriptionId%3D1234567890abcdef12345%26tag%3Dfoobar-20%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3DB0001BMXJ4"
            },
            {
              "Description": "All Offers",
              "URL": "http://www.amazon.com/gp/offer-listing/B0001BMXJ4%3FSubscriptionId%3D1234567890abcdef12345%26tag%3Dfoobar-20%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3DB0001BMXJ4"
            }
          ]
        },
        "ItemAttributes": {
          "Binding": "Kitchen",
          "Brand": "OXO",
          "CatalogNumberList": {
            "CatalogNumberListElement": [
              "ZZP-224",
              "1057954"
            ]
          },
          "Color": "Silver",
          "EAN": "0719812005904",
          "EANList": {
            "EANListElement": "0719812005904"
          },
          "Feature": [
            "Sturdy brushed stainless steel construction",
            "Subtle, soft, non-slip grip",
            "Stainless steel surface for safely leaning utensils on hot cookware",
            "Dishwasher safe",
            "Hole in handle for hanging"
          ],
          "ItemDimensions": {
            "Height": {
              "_": "100",
              "$": {
                "Units": "hundredths-inches"
              }
            },
            "Length": {
              "_": "1330",
              "$": {
                "Units": "hundredths-inches"
              }
            },
            "Weight": {
              "_": "25",
              "$": {
                "Units": "hundredths-pounds"
              }
            },
            "Width": {
              "_": "280",
              "$": {
                "Units": "hundredths-inches"
              }
            }
          },
          "Label": "OXO",
          "ListPrice": {
            "Amount": "999",
            "CurrencyCode": "USD",
            "FormattedPrice": "$9.99"
          },
          "Manufacturer": "OXO",
          "Model": "1057954",
          "MPN": "1057954",
          "PackageDimensions": {
            "Height": {
              "_": "150",
              "$": {
                "Units": "hundredths-inches"
              }
            },
            "Length": {
              "_": "1350",
              "$": {
                "Units": "hundredths-inches"
              }
            },
            "Weight": {
              "_": "40",
              "$": {
                "Units": "hundredths-pounds"
              }
            },
            "Width": {
              "_": "350",
              "$": {
                "Units": "hundredths-inches"
              }
            }
          },
          "PartNumber": "1057954",
          "ProductGroup": "Kitchen",
          "ProductTypeName": "KITCHEN",
          "Publisher": "OXO",
          "Studio": "OXO",
          "Title": "OXO Good Grips Brushed Stainless Steel Spoon",
          "UPC": "719812005904",
          "UPCList": {
            "UPCListElement": "719812005904"
          },
          "Warranty": "Satisfaction guarantee: if for any reason you are not satisfied with this OXO product, return it of repair, replacement or refund"
        },
        "OfferSummary": {
          "LowestNewPrice": {
            "Amount": "895",
            "CurrencyCode": "USD",
            "FormattedPrice": "$8.95"
          },
          "LowestUsedPrice": {
            "Amount": "990",
            "CurrencyCode": "USD",
            "FormattedPrice": "$9.90"
          },
          "TotalNew": "5",
          "TotalUsed": "1",
          "TotalCollectible": "0",
          "TotalRefurbished": "0"
        },
        "Offers": {
          "TotalOffers": "2",
          "TotalOfferPages": "1",
          "MoreOffersUrl": "http://www.amazon.com/gp/offer-listing/B0001BMXJ4%3FSubscriptionId%3D1234567890abcdef12345%26tag%3Dfoobar-20%26linkCode%3Dxm2%26camp%3D2025%26creative%3D386001%26creativeASIN%3DB0001BMXJ4",
          "Offer": [
            {
              "Merchant": {
                "Name": "~SunnyBreeze~"
              },
              "OfferAttributes": {
                "Condition": "New"
              },
              "OfferListing": {
                "OfferListingId": "ALBc3v3k5k9VtV%2Fw9jZzymqbmQWKpLGSHV7bK2V300WXyqk2s6qnw0MdICJpsZmqfwwcB52enlE7vKR7WMKZhjNX29ilUERTIiKaiep0WpsAB8S8bQjPQq4HcQVVvHO1zyeuUK3qGN6lynV4RZHQJ7Fy8vHuOAbJ",
                "Price": {
                  "Amount": "895",
                  "CurrencyCode": "USD",
                  "FormattedPrice": "$8.95"
                },
                "AmountSaved": {
                  "Amount": "104",
                  "CurrencyCode": "USD",
                  "FormattedPrice": "$1.04"
                },
                "PercentageSaved": "10",
                "Availability": "Usually ships in 1-3 weeks",
                "AvailabilityAttributes": {
                  "AvailabilityType": "now",
                  "MinimumHours": "264",
                  "MaximumHours": "360"
                },
                "IsEligibleForSuperSaverShipping": "0"
              }
            },
            {
              "Merchant": {
                "Name": "Vera's Hot Deals"
              },
              "OfferAttributes": {
                "Condition": "Used"
              },
              "OfferListing": {
                "OfferListingId": "ALBc3v3k5k9VtV%2Fw9jZzymqbmQWKpLGSQi5x3Oicadq8h3WWaU74PMjACypuFF2EPavHUZzSQUnbxPaO4CTRpWfhupIc1b6egv3qvEAdv6zbY7a3OnxNS9x2XWJaqVEcHEUq91PxcqFvt5T5Il6rs4ooujCVYRQ3",
                "Price": {
                  "Amount": "990",
                  "CurrencyCode": "USD",
                  "FormattedPrice": "$9.90"
                },
                "AmountSaved": {
                  "Amount": "9",
                  "CurrencyCode": "USD",
                  "FormattedPrice": "$0.09"
                },
                "PercentageSaved": "1",
                "Availability": "Usually ships in 1-2 business days",
                "AvailabilityAttributes": {
                  "AvailabilityType": "now",
                  "MinimumHours": "24",
                  "MaximumHours": "48"
                },
                "IsEligibleForSuperSaverShipping": "0"
              }
            }
          ]
        },
        "CustomerReviews": {
          "IFrameURL": "http://www.amazon.com/reviews/iframe?akid=1234567890abcdef12345&alinkCode=xm2&asin=B0001BMXJ4&atag=foobar-20&exp=2015-01-08T16%3A29%3A43Z&v=2&sig=p9caz4u2ZgoLHNfz0D%2Bmn%2BeQrNQlbSSGZ8Pb8YnJ3oY%3D",
          "HasReviews": "true"
        }
      }
    }
  }
}

/v1/getAsinCategories/:ASIN

Description

Hit the Amazon GetProductCategoriesForASIN endpoint and return a formatted, more readable version. The main category of a product is marked as main in the response.

Sample Request

http://research.api.sellerlabs.com/v1/getAsincategories/B0001BMXJ4

Sample Response

{
    "categoryMappings": [
        {
            "categoryId": "16439841",
            "category": "Cooking Utensils",
            "main": true
        },
        {
            "categoryId": "289754",
            "category": "Kitchen Utensils & Gadgets"
        },
        {
            "categoryId": "284507",
            "category": "Kitchen & Dining"
        },
        {
            "categoryId": "1063498",
            "category": "Categories"
        },
        {
            "categoryId": "1055398",
            "category": "Categories"
        },
        {
            "categoryId": "13900811",
            "category": "Home & Kitchen Features"
        },
        {
            "categoryId": "1055398",
            "category": "Home & Kitchen Features"
        },
        {
            "categoryId": "13900821",
            "category": "Kitchen & Dining Features"
        },
        {
            "categoryId": "1055398",
            "category": "Kitchen & Dining Features"
        },
        {
            "categoryId": "13750251",
            "category": "Barbecue Turners"
        },
        {
            "categoryId": "553762",
            "category": "Grilling & BBQ Utensils"
        },
        {
            "categoryId": "9001145011",
            "category": "Cooking Tools & Accessories"
        },
        {
            "categoryId": "13299251",
            "category": "Outdoor Cooking Tools & Accessories"
        },
        {
            "categoryId": "553760",
            "category": "Grills & Outdoor Cooking"
        },
        {
            "categoryId": "3238155011",
            "category": "Categories"
        },
        {
            "categoryId": "2972638011",
            "category": "Categories"
        }
    ]
}

/v1/getCategoryById/:CategoryId

Description

Get the Amazon product category associated to an Amazon category id, if we have the mapping. You can guarantee that the mapping exists if you first call any other ModernMWS endpoint with an ASIN with the category you are looking up.

Sample Request

http://research.api.sellerlabs.com/v1/getCategoryById/16439841

Sample Response

{
    "requestId": "25714bc0-968b-11e4-ba1a-b960e739b32f",
    "timestamp": "2015-01-07T16:35:10.076Z",
    "categoryId": "16439841",
    "category": "Cooking Utensils"
}

Sample Response

http://research.api.sellerlabs.com/v1/lookup?merchant_id=SellerLabsTest&marketplace_id=ATVPDKIKX0DER&asin=B0001BMXJ4&format=sphp&ts=1428820769&sig=1bdb40bfdfc7a0e68f0bc1dc8c1456a3