Data Feed API

Data Feed API allows a developer to get the list of products by category. Feed is refreshed once a day, so price and availability may not be always in sync with Developers should use the Product Lookup API to get real-time price and availability info if needed. The set of valid categories for downloading feeds is covered by the Taxonomy API. Data feed is available in compressed GZIP format. You can check the feed generation time by looking at Last-Modified HTTP header when you download the feed.

Access to the Feed API is restricted, and is available on a request basis. Developers are encouraged to use the Search API to search and list items conforming to a specific criteria such as by keyword or by category. To get access to the Feed API for a category or set of categories, please email us at clearly outlining the category ids access is needed for.

Example Query

JSON feed for Electronics{apiKey}&categoryId=3944


xml(deprecated), json

Query Parameters

Param NameDescriptionRequired/Optional
apiKey Your API access key Required
categoryId Category id of the category for feed download. This should match the id field from Taxonomy API Required
format Format of the feed file, allowed values are [json, xml(deprecated)]. Default is json. Optional


Feed API returns the Full Response. Response types are covered in the Item Response Groups section.

Sample Response

HTTP Headers

Content-Encoding: gzip

Content-MD5: OZkpYEWNkJwJJF5xY7pL/Q==

Content-Type: application/json; charset=utf-8

Date: Fri, 22 Nov 2013 09:29:19 GMT

Last-Modified: Thu Nov 21 04:45:06 PST 2013

Server: Mashery Proxy


transfer-encoding: chunked

Connection: keep-alive

Sample Item Data

  "itemId": 155984833,
  "parentItemId": 155984833,
  "name": "iPhone 6 Wallet Case | Stash Series | Brown",
  "salePrice": 4.99,
  "upc": "796201055153",
  "shortDescription": "Designed by Ghostek in New York",
  "longDescription": "<ul><li>Super Strong Polycarbonate Body with a Rubber Trim & 100% Premium Smooth Vintage Style PU Leather</li><li>Two Pocket Wallet (For Your Credit Cards, ID's & Cash) Doubles as a Kickstand and has a Magnetic Seal to Secure the Wallet to the Case</li><li>Features a Glass Armor 9H 0.33MM Thick Tempered Glass Screen Protector and a 1MM Raised Bevel for Added Screen Protection</li><li>Two Layers of Shockproof, Dust-Proof & Scratch-Proof Protection and still Thin & Lightweight!</li></ul>",
  "brandName": "Ghostek",
  "productTrackingUrl": "|LSNID|&offerid=223073.7200&type=14&catid=8&subid=0&hid=7200&tmpid=1082&",
  "standardShipRate": 0,
  "twoThreeDayShippingRate": 9.99,
  "marketplace": true,
  "sellerInfo": "Ghostek",
  "productUrl": "",
  "rhid": "38243",
  "bundle": false,
  "clearance": false,
  "preOrder": false,
  "stock": "Available",
  "addToCartUrl": "",
  "affiliateAddToCartUrl": "|LSNID|&offerid=223073.7200&type=14&catid=8&subid=0&hid=7200&tmpid=1082&",
  "freeShippingOver35Dollars": false,
  "availableOnline": true