Item Creation/Update Feed

Batch create or update items based on specified subcategories.

Each subcategory, there’s a category schema that needs to be followed (different subcategory requires different property input per item). You can download these schema(s) by the following methods:

  • Download Feed Schema
  • There are two options available for downloading the schemas for different sub-categories:
    • Newegg seller portal feed schema download, go to Newegg Seller Portal > Manage Items > Batch Item Creation/Update > Download File Template tab > Action: “Batch Item Creation” > Select “Extensible Markup Language(*.xml)” > Select “Industry” > Click “DOWNLOAD FILE TEMPLATE”
    • Or download the complete schema package http://images10.newegg.com/Marketplace/Taxonomy/XSD.zip

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: 1.0
MessageType Yes String Fixed value: BatchItemCreation
SubCategoryID Yes String Identify the category specification. There is only one category can be used for any single item.

Note: Once an item is created or exist in Newegg, this information cannot be updated.

Action No String Specify the action you would like to perform, types of action:

Create Item: Create a new product that is not currently in your item list.

Update Item: Update the information of a product already in your item list (does NOT include updating of pricing fields: Currency, MSRP, MAP, Selling Price, Shipping, Inventory and Activation Mark)

Update/Append Image: Upload additional image(s) of the product or overwrite existing image(s).

Replace Image: Replace all of your existing images with the image URL’s provided in this file. When this action is selected, the system will only process the Item Images field and Activation Mark; all other information, including Selling Price, will be ignore.

IMPORTANT: If no action is selected, by default, system will use Create Item action.

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.

RelatedSellerPartNumber No String If the item is a variant of another (“related”) item with its own seller part #, list the related item’s seller part # here.
This is required for the variant item to display under a single product page. An alphanumeric string, max 40 characters including space.
NOTE: Once an item is created, this information cannot be updated.
WebsiteShortTitle Yes String The short, easily identifiable item name for an item. It will be used as the main name for your product on all store pages, sales orders and receipts.

Max characters: 200

BulletDescription Yes String Enter concise descriptions of selected product features or functions which will be listed by bullet point below the website short/long title on the product page. Use separator “^^” to separate different points.
Max characters: 1000, including spaces and separators.NO HTML is allowed.
ProductDescription Yes String The detailed description to be featured on the item page. This description should state the features and functions of the product.  Should be the same for all items in product family.

Max characters: 4000

Accepted HTML tags for Product Description fields: <ol>,<ul>, <li>,<br>, <p>, <b>, <i>, <u>, <em>, <strong>, <sub>, <sup> and <img>

ItemLength No Decimal Item’s shipping length in inches, value only, do not include the metric unit.

Format: Two digits after decimal point.  Example: 1.00

ItemWidth No Decimal Item’s shipping width in inches, value only, do not include the metric unit.

Format: Two digits after decimal point.  Example: 1.00

ItemHeight No Decimal Item’s shipping height in inches, value only, do not include the metric unit.

Format: Two digits after decimal point.  Example: 1.00

ItemWeight Yes Decimal Item’s shipping weight in pounds, value only, do not include the metric unit.

Format: Two digits after decimal point.  Example: 1.00

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.

ItemPackage No String Item’s package is either “Retail”or “OEM” packaging. Default will be set to “Retail” if no value specified.
ShippingRestriction No String Certain item’s have shipping restrictions where the item cannot be shipped through air.

If the item you are creating has such restriction, set value to “Yes”. Otherwise, set it to “No”. If not included/blank/null, the default is “No”.

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:

Newegg.com and Neweggbusiness.com platform default is USA warehouse

Newegg.ca platform default is CAN warehouse

Note: Newegg.com only, multiple warehouse(s) or Newegg Global program, please submit Inventory Update Feed to manage inventory.

LimitQuantity No Integer Limit quantity represents the maximum quantity this item can be purchased by a customer within a 48 hour time period.

NOTE:

  • Limit Quantity is an integer between 1 and 500.
  • If blank/null then it means “Don’t Update it”.
  • If you want to delete the existing Limit Quantity of the item, please put 0 in Limit Quantity Field.
ActivationMark No String Available values:

True: Activate item, the product will be listed for sale at Newegg website.
False: Deactivate item, the product will be hidden/offline, not 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.

Newegg.com platform for Newegg global, please submit Update Price request feed to manage activation for global SKUs.

ImageUrl Yes String Image URL for this item’s product image.

Requirements:

URLs must be a direct link to actual image

Image format: *.JPG, *.JPEG, *.GIF

Minimum image dimension: 640 pixels width and 480 pixels height

Max size for each image is 10MB, if size exceeds 10MB, it will fail

IsPrimary No Boolean Specify one default image, if multiple images will be uploaded.
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:

URLs must be a direct link to actual image

Image format: *.JPG, *.JPEG, *.GIF

Minimum image dimension: 640 pixels width and 480 pixels height

Max size for each image is 10MB, if size exceeds 10MB, it will fail

Note: This information is only applicable for Newegg.com platform.

IsPrimary No String Specify one default image for USED item, if multiple images will be uploaded.
Prop65 No String Newegg.com and Neweggbusiness.com:  This field is not being used.

Once item has been created, to update prop 65 accordingly for regulations in California refer to ITEM_CAPROP65_DATA feed.

Newegg.ca platform not required

Prop65Motherboard No String
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
OverAge18Verification No String Used if the product contains graphics or adult content that is inappropriate for person under 18 years old. If not included/blank/null, the default is “No”

Available values: “Yes” or “No”

ChokingHazard No String Choking Hazard Warning Requirements for Children’s Toys and Games, you may select up to four of these six warnings.

You should never need to choose more than four warnings, as a warning that a product “contains” a small ball or marble should not apply simultaneously with the corresponding warning that a product “is” a small ball or marble.

Please refer to Consumer Product Safety Improvement Act (CPSIA) for more information.

If not included/blank/null, the value will be blank.

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.
SubCategoryProperty Yes Vary Section containing category-specific information such as properties. Reference the
following XSDs to complete the Product Data section.Download Feed SchemaNewegg seller portal feed schema download, go to Newegg Seller Portal > Manage Items > Batch Item Creation/Update > Download File Template tab > Action: “Batch Item Creation” > Select “Extensible Markup Language(*.xml)” > Select “Industry” > Click “DOWNLOAD FILE TEMPLATE”Note:Only one category can be used for a given item.If there is “Required” properties for specified category and not provided, the feed will fail to process.

Schema: Itemfeed.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>1.0</DocumentVersion>
    </Header>
    <MessageType>BatchItemCreation</MessageType>
    <Message>
        <Itemfeed>
            <SummaryInfo>
                <SubCategoryID>13905</SubCategoryID>
            </SummaryInfo>
            <Item>
                <Action>Create Item</Action>
                <BasicInfo>
                    <SellerPartNumber>JACKETEST0921001002</SellerPartNumber>
                    <Manufacturer>AMD</Manufacturer>
                    <ManufacturerPartsNumber>JACKETEST0921001002</ManufacturerPartsNumber>
                    <UPCOrISBN></UPCOrISBN>
                    <ManufacturerItemURL></ManufacturerItemURL>
                    <RelatedSellerPartNumber></RelatedSellerPartNumber>
                    <WebsiteShortTitle>Sick1111111</WebsiteShortTitle>
                    <BulletDescription>This is first bullet^^This is second bullet</BulletDescription>
                    <ProductDescription>hello222222</ProductDescription>
                    <ItemDimension>
                        <ItemLength>4</ItemLength>
                        <ItemWidth>5</ItemWidth>
                        <ItemHeight>6</ItemHeight>
                    </ItemDimension>
                    <ItemWeight>3</ItemWeight>
                    <PacksOrSets>1</PacksOrSets>
                    <ItemCondition>New</ItemCondition>
                    <ItemPackage>OEM</ItemPackage>
                    <ShippingRestriction>Yes</ShippingRestriction>
                    <Currency>USD</Currency>
                    <SellingPrice>100</SellingPrice>
                    <Shipping>Free</Shipping>
                    <Inventory>100</Inventory>
                    <LimitQuantity>1</LimitQuantity>
                    <ActivationMark>True</ActivationMark>
                    <ItemImages>
                        <Image>
                            <ImageUrl>http://10.1.24.143:4567/images/20.gif</ImageUrl>
                        </Image>
                        <Image>
                            <ImageUrl>http://10.1.24.143:4567/images/21.gif</ImageUrl>
                        </Image>
                        <Image>
                            <ImageUrl>http://10.1.24.143:4567/images/22.gif</ImageUrl>
                        </Image>
                    </ItemImages>
                    <Warning>
                        <Prop65>No</Prop65>
                        <Prop65Motherboard>Yes</Prop65Motherboard>
                        <OverAge18Verification>Yes</OverAge18Verification>
                        <ChokingHazard>
                            <SmallParts>Yes</SmallParts>
                            <SmallBall>Is a small ball</SmallBall>
                            <Balloons>Yes</Balloons>
                            <Marble>Is a marble</Marble>
                        </ChokingHazard>
                    </Warning>
                </BasicInfo>
                <SubCategoryProperty>
                    <CostumeAccessories>
                        <CostumeAccBrand>String</CostumeAccBrand>
                        <CostumeAccModel>String</CostumeAccModel>
                        <CostumeAccGender>Male</CostumeAccGender>
                        <CostumeAccAge>Adult</CostumeAccAge>
                        <CostumeAccType>Blood &amp; Gore</CostumeAccType>
                        <CostumeAccTheme>Animals &amp; Insects</CostumeAccTheme>
                        <CostumeAccOccasion>1st Birthday</CostumeAccOccasion>
                        <CostumeAccSize>#10</CostumeAccSize>
                        <CostumeAccColor>String</CostumeAccColor>
                        <CostumeAccMaterial>String</CostumeAccMaterial>
                        <CostumeAccCareInstructions>String</CostumeAccCareInstructions>
                    </CostumeAccessories>
                </SubCategoryProperty>
            </Item>
            <Item>
                <Action>Create Item</Action>
                <BasicInfo>
                    <SellerPartNumber>JACKETEST0921001003</SellerPartNumber>
                    <Manufacturer>AMD</Manufacturer>
                    <ManufacturerPartsNumber>JACKETEST0921001003</ManufacturerPartsNumber>
                    <UPCOrISBN></UPCOrISBN>
                    <ManufacturerItemURL></ManufacturerItemURL>
                    <RelatedSellerPartNumber></RelatedSellerPartNumber>
                    <WebsiteShortTitle>Sick1111111</WebsiteShortTitle>
                    <BulletDescription>This is first bullet^^This is second bullet</BulletDescription>
                    <ProductDescription>hello222222</ProductDescription>
                    <ItemDimension>
                        <ItemLength>4</ItemLength>
                        <ItemWidth>5</ItemWidth>
                        <ItemHeight>6</ItemHeight>
                    </ItemDimension>
                    <ItemWeight>5</ItemWeight>
                    <PacksOrSets>1</PacksOrSets>
                    <ItemCondition>UsedGood</ItemCondition>
                    <ItemPackage>OEM</ItemPackage>
                    <ShippingRestriction>Yes</ShippingRestriction>
                    <Currency>USD</Currency>
                    <SellingPrice>100</SellingPrice>
                    <Shipping>Free</Shipping>
                    <Inventory>100</Inventory>
                    <LimitQuantity>1</LimitQuantity>
                    <ActivationMark>True</ActivationMark>
                    <ItemImages>
                        <Image>
                            <ImageUrl>http://10.1.24.143:4567/images/20.gif</ImageUrl>
                        </Image>
                    </ItemImages>
                    <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>
                    <Warning>
                        <Prop65>No</Prop65>
                        <Prop65Motherboard>Yes</Prop65Motherboard>
                        <OverAge18Verification>Yes</OverAge18Verification>
                        <ChokingHazard>
                            <SmallParts>Yes</SmallParts>
                            <SmallBall>Is a small ball</SmallBall>
                            <Balloons>Yes</Balloons>
                            <Marble>Is a marble</Marble>
                        </ChokingHazard>
                    </Warning>
                </BasicInfo>
                <SubCategoryProperty>
                    <CostumeAccessories>
                        <CostumeAccBrand>String</CostumeAccBrand>
                        <CostumeAccModel>String</CostumeAccModel>
                        <CostumeAccGender>Male</CostumeAccGender>
                        <CostumeAccAge>Adult</CostumeAccAge>
                        <CostumeAccType>Blood &amp; Gore</CostumeAccType>
                        <CostumeAccTheme>Animals &amp; Insects</CostumeAccTheme>
                        <CostumeAccOccasion>1st Birthday</CostumeAccOccasion>
                        <CostumeAccSize>#10</CostumeAccSize>
                        <CostumeAccColor>String</CostumeAccColor>
                        <CostumeAccMaterial>String</CostumeAccMaterial>
                        <CostumeAccCareInstructions>String</CostumeAccCareInstructions>
                    </CostumeAccessories>
                </SubCategoryProperty>
            </Item>
            <Item>
                <Action>Create Item</Action>
                <BasicInfo>
                    <SellerPartNumber>JACKETEST0921001004</SellerPartNumber>
                    <Manufacturer>AMD</Manufacturer>
                    <ManufacturerPartsNumber>JACKETEST0921001004</ManufacturerPartsNumber>
                    <UPCOrISBN></UPCOrISBN>
                    <ManufacturerItemURL></ManufacturerItemURL>
                    <RelatedSellerPartNumber></RelatedSellerPartNumber>
                    <WebsiteShortTitle>Sick1111111</WebsiteShortTitle>
                    <ProductDescription>hello222222</ProductDescription>
                    <ItemDimension>
                        <ItemLength>4</ItemLength>
                        <ItemWidth>5</ItemWidth>
                        <ItemHeight>6</ItemHeight>
                    </ItemDimension>
                    <ItemWeight>3</ItemWeight>
                    <PacksOrSets>1</PacksOrSets>
                    <ItemCondition>New</ItemCondition>
                    <ItemPackage>OEM</ItemPackage>
                    <ShippingRestriction>Yes</ShippingRestriction>
                    <Currency>USD</Currency>
                    <SellingPrice>100</SellingPrice>
                    <Shipping>Free</Shipping>
                    <Inventory>100</Inventory>
                    <LimitQuantity>1</LimitQuantity>
                    <ActivationMark>True</ActivationMark>
                    <ItemImages>
                        <Image>
                            <ImageUrl>http://10.1.24.143:4567/images/20.gif</ImageUrl>
                        </Image>
                    </ItemImages>
                    <Warning>
                        <Prop65>No</Prop65>
                        <Prop65Motherboard>Yes</Prop65Motherboard>
                        <CountryOfOrigin>USA</CountryOfOrigin>
                        <OverAge18Verification>Yes</OverAge18Verification>
                        <ChokingHazard>
                            <SmallParts>Yes</SmallParts>
                            <SmallBall>Is a small ball</SmallBall>
                            <Balloons>Yes</Balloons>
                            <Marble>Is a marble</Marble>
                        </ChokingHazard>
                       <LeadTime>4</LeadTime>
                       <ShippingTemplate>M1</ShippingTemplate>
                    </Warning>
                </BasicInfo>
                <SubCategoryProperty>
                    <CostumeAccessories>
                        <CostumeAccBrand>String</CostumeAccBrand>
                        <CostumeAccModel>String</CostumeAccModel>
                        <CostumeAccGender>Male</CostumeAccGender>
                        <CostumeAccAge>Adult</CostumeAccAge>
                        <CostumeAccType>Blood &amp; Gore</CostumeAccType>
                        <CostumeAccTheme>Animals &amp; Insects</CostumeAccTheme>
                        <CostumeAccOccasion>1st Birthday</CostumeAccOccasion>
                        <CostumeAccSize>#10</CostumeAccSize>
                        <CostumeAccColor>String</CostumeAccColor>
                        <CostumeAccMaterial>String</CostumeAccMaterial>
                        <CostumeAccCareInstructions>String</CostumeAccCareInstructions>
                    </CostumeAccessories>
                </SubCategoryProperty>
            </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": "1.0" },
    "MessageType": "BatchItemCreation",
    "Message": {
      "Itemfeed": {
        "SummaryInfo": { "SubCategoryID": "13905" },
        "Item": [
          {
            "Action": "Create Item",
            "BasicInfo": {
              "SellerPartNumber": "JACKETEST0921001002",
              "Manufacturer": "AMD",
              "ManufacturerPartsNumber": "JACKETEST0921001002",
              "WebsiteShortTitle": "Sick1111111",
              "BulletDescription":"This is first bullet^^This is second bullet",
              "ProductDescription": "hello222222",
              "ItemDimension": {
                "ItemLength": "4",
                "ItemWidth": "5",
                "ItemHeight": "6"
              },
              "ItemWeight": "3",
              "PacksOrSets": "1",
              "ItemCondition": "New",
              "ItemPackage": "OEM",
              "ShippingRestriction": "Yes",
              "Currency": "USD",
              "SellingPrice": "100",
              "Shipping": "Free",
              "Inventory": "100",
              "LimitQuantity": "1",
              "ActivationMark": "True",
              "ItemImages": {
                "Image": [
                     { "ImageUrl": "http://10.1.24.143:4567/images/20.gif" },
                     { "ImageUrl": "http://10.1.24.143:4567/images/21.gif" },
                     { "ImageUrl": "http://10.1.24.143:4567/images/22.gif" }
                ]
              },
              "Warning": {
                "Prop65": "No",
                "Prop65Motherboard": "Yes",
                "OverAge18Verification": "Yes",
                "ChokingHazard": {
                  "SmallParts": "Yes",
                  "SmallBall": "Is a small ball",
                  "Balloons": "Yes",
                  "Marble": "Is a marble"
                }
              }
            },
            "SubCategoryProperty": {
              "CostumeAccessories": {
                "CostumeAccBrand": "String",
                "CostumeAccModel": "String",
                "CostumeAccGender": "Male",
                "CostumeAccAge": "Adult",
                "CostumeAccType": "Blood & Gore",
                "CostumeAccTheme": "Animals & Insects",
                "CostumeAccOccasion": "1st Birthday",
                "CostumeAccSize": "#10",
                "CostumeAccColor": "String",
                "CostumeAccMaterial": "String",
                "CostumeAccCareInstructions": "String"
              }
            }
          },
          {
            "Action": "Create Item",
            "BasicInfo": {
              "SellerPartNumber": "JACKETEST0921001003",
              "Manufacturer": "AMD",
              "ManufacturerPartsNumber": "JACKETEST0921001003",
              "WebsiteShortTitle": "Sick1111111",
              "BulletDescription":"This is first bullet^^This is second bullet",
              "ProductDescription": "hello222222",
              "ItemDimension": {
                "ItemLength": "4",
                "ItemWidth": "5",
                "ItemHeight": "6"
              },
              "ItemWeight": "5",
              "PacksOrSets": "1",
              "ItemCondition": "UsedGood",
              "ItemPackage": "OEM",
              "ShippingRestriction": "Yes",
              "Currency": "USD",
              "SellingPrice": "100",
              "Shipping": "Free",
              "Inventory": "100",
              "LimitQuantity": "1",
              "ActivationMark": "True",
              "ItemImages": {
                "Image": { "ImageUrl": "http://10.1.24.143:4567/images/20.gif" }
              },
              "ConditionDetails": "Works fine, almost like new, missing original plastics cover.",
              "UsedItemImages": {
                "Image": { "ImageUrl": "http://10.1.24.143:4567/images/Used.gif" }
              },
              "Warning": {
                "Prop65": "No",
                "Prop65Motherboard": "Yes",
                "OverAge18Verification": "Yes",
                "ChokingHazard": {
                  "SmallParts": "Yes",
                  "SmallBall": "Is a small ball",
                  "Balloons": "Yes",
                  "Marble": "Is a marble"
                }
              }
            },
            "SubCategoryProperty": {
              "CostumeAccessories": {
                "CostumeAccBrand": "String",
                "CostumeAccModel": "String",
                "CostumeAccGender": "Male",
                "CostumeAccAge": "Adult",
                "CostumeAccType": "Blood & Gore",
                "CostumeAccTheme": "Animals & Insects",
                "CostumeAccOccasion": "1st Birthday",
                "CostumeAccSize": "#10",
                "CostumeAccColor": "String",
                "CostumeAccMaterial": "String",
                "CostumeAccCareInstructions": "String"
              }
            }
          },
          {
            "Action": "Create Item",
            "BasicInfo": {
              "SellerPartNumber": "JACKETEST0921001004",
              "Manufacturer": "AMD",
              "ManufacturerPartsNumber": "JACKETEST0921001004",
              "WebsiteShortTitle": "Sick1111111",
              "ProductDescription": "hello222222",
              "ItemDimension": {
                "ItemLength": "4",
                "ItemWidth": "5",
                "ItemHeight": "6"
              },
              "ItemWeight": "3",
              "PacksOrSets": "1",
              "ItemCondition": "New",
              "ItemPackage": "OEM",
              "ShippingRestriction": "Yes",
              "Currency": "USD",
              "SellingPrice": "100",
              "Shipping": "Free",
              "Inventory": "100",
              "LimitQuantity": "1",
              "ActivationMark": "True",
              "ItemImages": {
                "Image": { "ImageUrl": "http://10.1.24.143:4567/images/20.gif" }
              },
              "Warning": {
                "Prop65": "No",
                "Prop65Motherboard": "Yes",
                "CountryOfOrigin": "USA",
                "OverAge18Verification": "Yes",
                "ChokingHazard": {
                  "SmallParts": "Yes",
                  "SmallBall": "Is a small ball",
                  "Balloons": "Yes",
                  "Marble": "Is a marble"
                }
                "LeadTime": "4",
                "ShippingTemplate" : "M1",
              }
            },
            "SubCategoryProperty": {
              "CostumeAccessories": {
                "CostumeAccBrand": "String",
                "CostumeAccModel": "String",
                "CostumeAccGender": "Male",
                "CostumeAccAge": "Adult",
                "CostumeAccType": "Blood & Gore",
                "CostumeAccTheme": "Animals & Insects",
                "CostumeAccOccasion": "1st Birthday",
                "CostumeAccSize": "#10",
                "CostumeAccColor": "String",
                "CostumeAccMaterial": "String",
                "CostumeAccCareInstructions": "String"
              }
            }
          }
        ]
      }
    }
  }
}

Response Body

Attribute Format Description
IsSuccess String Get feed status operation:

True: Successful
False: Not 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: August 25, 2022