Existing Item Creation Feed
Batch create items by matching against existing items in Newegg catalog.
The main intent of this approach is to let sellers listing an item using ISBN, UPC, Manufacturer Part Number, or Newegg Item Number without specifying sub-category related information. This helps sellers creating the items more quickly.
Resource URL
Newegg.com: https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}
Newegg.ca: https://api.newegg.com/marketplace/can/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}
Note: Please make sure your request URL is all in lower case (except for Seller ID) and cannot contain any blank spaces or line breaks.
Parameters
| Name | Required? | Description |
| sellerid | Yes | Your seller ID on Newegg Marketplace |
| RequestType | Yes | Value: ITEM_DATA |
Resource Information
| HTTP Method | Authentication? | Request Formats | Response Formats | Rate Limited? | Maximum Size of Request |
| POST | Required | XML, Json | XML, Json | 10 request per minute | Max: 3000 records per file and each file cannot exceed 15 MB
Limit: 30,000 records per hour |
Request Body
| Attribute | Required? | Format | Description |
| DocumentVersion | Yes | Decimal | Fixed value: 2.0 |
| MessageType | Yes | String | Fixed value: BatchItemCreation |
| SellerPartNumber | Yes | String | A seller-defined unique identifier for an item. An alphanumeric string, max 40 characters including space. Note: Once an item is created, this information cannot be updated. |
| Manufacturer | Yes | String | The manufacturer name for an item. This is pre-defined in Newegg system. Request to add manufacturer(s) send to Newegg Content Team at mktp.content@newegg.com. Note: Once an item is created, this information cannot be updated. |
| ManufacturerPartsNumber | Yes, if UPC code is not provided | String | Manufacturer defined unique identifier for an item. An alphanumeric string, max 40 characters including space. Note: Once an item is created, this information cannot be updated. |
| UPCOrISBN | Yes, if Manufacturer Part # / ISBN is not provided |
String | A unique Universal Product Code (UPC) (12 characters only) or European Article Number (EAN)(13 characters only) for an item. A numeric string, max 40 characters. NOTE: Once an item is created, this information cannot be updated. |
| NeweggItemNumber | Yes, if UPC code AND Manufacturer Part # / ISBN is not provided |
String | Newegg’s unique identifier for an item. |
| Currency | No | String | The form of money for all price related fields. Available values: USD: For Newegg.com and Neweggbusiness.com platforms CAD: For Newegg.ca platform If no value is specified system will use default currency “CAD” for Newegg.ca and “USD” for Newegg.com and Neweggbusiness.com. |
| MAP | No | Decimal | Dictates the “minimum advertised price” for item. Format: 10 digits allowed to the left of the decimal point and 2 digits to the right of the decimal point. Please do not use commas or dollar signs. If the Selling Price is below the defined MAP, the website will ask customer to add item to shopping cart to see the item’s price. If you want to remove MAP, input “0.00” or “0”. If null, no change to current setting. |
| CheckoutMAP | No | String | When Checkout MAP is marked as “True” AND the selling price is lower than MAP price then the selling price will not be displayed until the checkout process. Available values: “True” or “False” |
| SellingPrice | Yes | Decimal | The actual price at which the item is offered for sale. Format: 10 digits allowed to the left of the decimal point and 2 digits to the right of the decimal point. Please do not use commas or dollar signs. |
| Shipping | Yes | String | The shipping charge setting for item. Available values: “Default” or “Free” Shipping charge for “Default” setting is determined by seller’s shipping rate setting at Newegg Seller Portal > Manage Account > Shipping Settings. |
| Inventory | Yes | Integer | The inventory quantity available for default warehouse location:
Note: Newegg.com only, multiple warehouse(s) or Newegg Global program, please submit Inventory Update Feed to manage inventory. |
| ItemCondition | No | String | Available values for Item Condition: New: Product will ship as received by the manufacturer, sealed, with all advertised components, and with the manufacturer warranty. Refurbished: Product was tested and repaired as required to meet the standards of the refurbisher, which may or may not be the original manufacturer. Any exceptions to the condition of the item outside the manufacturer’s information should be provided in the listing, up to and including warranty details. Additional values for Newegg.com platform: UsedLikeNew: Product has been opened, possibly used but is in perfect factory condition with no signs of cosmetic or functional defect. Product includes warranty, and accessories found with the original product. Product may or may not be in the original packaging. Returned items with minor packaging defects fall under this category. UsedVeryGood: Product has been opened, may show slight signs of use and cosmetic blemish, and may be missing minor accessories, but remain in excellent condition. Product does not come with warranty unless stated otherwise in product description. UsedGood: Product has been used, may show clear signs of use and may be missing minor accessories, but remain in good condition. Product does not come with warranty unless stated otherwise in product description. UsedAcceptable: Product shows clear signs of use, cosmetic defect, and may be missing minor accessories and manual, but remain in working condition. Product does not come with warranty unless stated otherwise in product description. Functionality issues beyond signs of use should be disclosed in product description. Note: Once an item is created, this information cannot be updated. |
| PacksOrSets | Yes | Integer | Identify the package count of this product. All products in a pack or set will have matching item and condition.
Note: Once an item is created, this information cannot be updated. |
| ActivationMark | No | String | Available values:
True: Activate item, the product will be listed for sale at Newegg website. If Null, system will do nothing, no change to current item active/deactivate status. Note: If Newegg Seller account status is “Inactive”, all items will be offline. To have option to “Active” item, the account status should be “Active”. Please contact datafeeds@newegg.com for details. |
| ConditionDetails | No | String | Information related to the condition, not including New or Refurbished, of the product can be described here to help customer understanding the product.
Note: This information is only applicable for Newegg.com platform. |
| ImageUrl | No | String | Image URL for USED item’s product image.
Requirements:
Note: This information is only applicable for Newegg.com platform. |
| IsPrimary | No | Boolean | Specify one default image for USED item, if multiple images will be uploaded. |
| CountryOfOrigin | No | String | Country of Origin is the country of manufacture/ production of your items. Newegg only accept ISO standard three-letter codes for the various countries of the world. For complete list, please refer to the following: International Country Guide |
| LeadTime | No | Integer | Max 14 business days. Estimated delivery time is calculated based on leading time. You must ship the order within this time for good “On-time Order Fulfillment Rate” performance. Default will be 2 days, if you leave it blank. 1~14 |
| ShippingTemplate | No | String | Binding the Shipping setting by shipping template name. If you leave it blank, the bound template will not be updated. An alphanumeric string. Maximum characters: 200. |
Schema: ExistingFeed.xsd
Example: XML, Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggEnvelope>
<Header>
<DocumentVersion>2.0</DocumentVersion>
</Header>
<MessageType>BatchItemCreation</MessageType>
<Message>
<Itemfeed>
<SummaryInfo/>
<Item>
<BasicInfo>
<SellerPartNumber>a006-test-008</SellerPartNumber>
<Manufacturer>Newegg</Manufacturer>
<ManufacturerPartsNumber>manu-008</ManufacturerPartsNumber>
<UPCOrISBN>123456789012</UPCOrISBN>
<NeweggItemNumber>9SIAWE50389435</NeweggItemNumber>
<Currency>USD</Currency>
<MAP>5.00</MAP>
<CheckoutMAP>True</CheckoutMAP>
<SellingPrice>9.99</SellingPrice>
<Shipping>Default</Shipping>
<Inventory>99</Inventory>
<ItemCondition>UsedGood</ItemCondition>
<PacksOrSets>1</PacksOrSets>
<ActivationMark>True</ActivationMark>
<ConditionDetails> Works fine, almost like new, missing original plastics cover </ConditionDetails>
<UsedItemImages>
<Image>
<ImageUrl>http://10.1.24.143:4567/images/Used.gif</ImageUrl>
</Image>
</UsedItemImages>
<CountryOfOrigin>USA</CountryOfOrigin>
<LeadTime>4</LeadTime>
<ShippingTemplate>M1</ShippingTemplate>
</BasicInfo>
</Item>
<Item>
<BasicInfo>
<SellerPartNumber>a006-test-009</SellerPartNumber>
<Manufacturer>Newegg</Manufacturer>
<ManufacturerPartsNumber>manu-009</ManufacturerPartsNumberOrISBN>
<UPCOrISBN>123456789012</UPCOrISBN>
<NeweggItemNumber>9SIAWE50389434</NeweggItemNumber>
<Currency>USD</Currency>
<MAP>5.00</MAP>
<SellingPrice>9.99</SellingPrice>
<Shipping>Default</Shipping>
<Inventory>99</Inventory>
<ItemCondition>New</ItemCondition>
<PacksOrSets>1</PacksOrSets>
<ActivationMark>True</ActivationMark>
</BasicInfo>
</Item>
</Itemfeed>
<Itemfeed>
<SummaryInfo/>
<Item>
<BasicInfo>
<SellerPartNumber>a006-test-010</SellerPartNumber>
<Manufacturer>Newegg</Manufacturer>
<ManufacturerPartsNumber>manu-010</ManufacturerPartsNumber>
<UPCOrISBN>123456789012</UPCOrISBN>
<NeweggItemNumber>9SIAWE50389432</NeweggItemNumber>
<Currency>USD</Currency>
<MAP>5.00</MAP>
<SellingPrice>9.99</SellingPrice>
<Shipping>Default</Shipping>
<Inventory>99</Inventory>
<ItemCondition>New</ItemCondition>
<ActivationMark>True</ActivationMark>
<PacksOrSets>1</PacksOrSets>
</BasicInfo>
</Item>
</Itemfeed>
</Message>
</NeweggEnvelope>
Example: Json, Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"Header": {
"DocumentVersion": "2.0"
},
"MessageType": "BatchItemCreation",
"Message": {
"Itemfeed": [
{
"Item": [
{
"BasicInfo": {
"SellerPartNumber": "a006-test-008",
"Manufacturer": "Newegg",
"ManufacturerPartsNumber": "manu-008",
"UPCOrISBN": "123456789012",
"NeweggItemNumber": "9SIAWE50389435",
"Currency": "USD",
"MAP": "5.00",
"CheckoutMAP": "True",
"SellingPrice": "9.99",
"Shipping": "Default",
"Inventory": "99",
"ItemCondition": "UsedGood",
"PacksOrSets": "1",
"ActivationMark": "True",
"ConditionDetails": " Works fine, almost like new, missing original plastics cover",
"UsedItemImages": {
"Image": {
"ImageUrl": "http://10.1.24.143:4567/images/Used.gif"
}
"CountryOfOrigin": "USA",
"LeadTime": "4",
"ShippingTemplate" : "M1",
}
}
},
{
"BasicInfo": {
"SellerPartNumber": "a006-test-009",
"Manufacturer": "Newegg",
"ManufacturerPartsNumber": "manu-009",
"UPCOrISBN": "123456789012",
"NeweggItemNumber": "9SIAWE50389434",
"Currency": "USD",
"MAP": "5.00",
"SellingPrice": "9.99",
"Shipping": "Default",
"Inventory": "99",
"ItemCondition": "New",
"PacksOrSets": "1",
"ActivationMark": "True"
}
}
]
},
{
"Item": {
"BasicInfo": {
"SellerPartNumber": "a006-test-010",
"Manufacturer": "Newegg",
"ManufacturerPartsNumber": "manu-010",
"UPCOrISBN": "123456789012",
"NeweggItemNumber": "9SIAWE50389432",
"Currency": "USD",
"MAP": "5.00",
"SellingPrice": "9.99",
"Shipping": "Default",
"Inventory": "99",
"ItemCondition": "New",
"ActivationMark": "True",
"PacksOrSets": "1"
}
}
}
]
}
}
}
Response Body
| Attribute | Format | Description |
| IsSuccess | String | Get feed status operation:
True: Successful |
| OperationType | String | Fixed value: SubmitFeedResponse |
| SellerID | String | Your seller ID |
| RequestType | String | Value: ITEM_DATA |
| RequestDate | String | The date when the feed was submitted. (Pacific Standard Time) |
| RequestStatus | String | The status of the feed submission:
SUBMITTED |
| Memo | String | Additional Information |
Schema: SubmitFeedResponse.xsd
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>SubmitFeedResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<ResponseList>
<ResponseInfo>
<RequestId>2291326430</RequestId>
<RequestType>ITEM_DATA</RequestType>
<RequestDate>2/16/2012 12:29:19</RequestDate>
<RequestStatus>SUBMITTED</RequestStatus>
</ResponseInfo>
</ResponseList>
</ResponseBody>
<Memo />
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": true,
"OperationType": "SubmitFeedResponse",
"ResponseBody": {
"ResponseList": [
{
"RequestDate": "2/22/2012 17:24:35",
"RequestId": "2PQCX3CMQ82MK",
"RequestStatus": "SUBMITTED",
"RequestType": "ITEM_DATA"
}
]
},
"SellerID": "A006"
}
Request Failure Errors
For common HTTP error responses, please refer to Failed Response Error Code List.
| Error Code | Description |
| DF003 | The MaxCount (maximum request records) CANNOT be over 30000. |
| DF004 | Unfortunately, we are unable to process your request at this time. We apologize for the inconvenience. Please try again later. |
| DF011 | Your data feed request will not be processed during the scheduled data feed processing restriction from [{begin timestamp: hh:mm:ss, MM/DD/YYYY}] to [{end timestamp: hh:mm:ss, MM/DD/YYYY}]). Please contact datafeeds@newegg.com if you have any question or concern. Thank you for your patience. |
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>DF003</Code>
<Message>The MaxCount (maximum request records) CANNOT be over 30000</Message>
</Error>
</Errors>
Example: Json, Response
[
{
"Code": "DF003",
"Message": "The MaxCount (maximum request records) CANNOT be over 30000"
}
]
Last updated: March 9, 2021