Get Item Basic Information Report

Get a list of seller’s available item basic information.

Resource URL

Newegg.com: https://api.newegg.com/marketplace/reportmgmt/report/result?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/reportmgmt/report/result?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/reportmgmt/report/result?sellerid={sellerid}

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

Resource Information

HTTP Method Authentication? Request Formats Response Formats Rate Limited?
PUT Required XML, Json XML, Json 500 request per hour

Request Body

Attribute Required? Format Description
IssueUser No String Issuer’s registered Seller Portal email address. System will only accept Seller’s registered Seller Portal email addresses. If left blank, default value will be Seller ID.
OperationType Yes String Fixed values: ItemBasicInfoReportRequest
RequestID Yes String Newegg’s assigned ID for submitted request

Schema: GetReportRequest.xsd

Example: XML, Request

PUT https://api.newegg.com/marketplace/reportmgmt/report/result?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggAPIRequest >
    <OperationType>ItemBasicInfoReportRequest</OperationType>
    <RequestBody>
        <RequestID>245VV9QOCM6BK</RequestID>
    </RequestBody>
</NeweggAPIRequest>

Example: Json, Request

PUT https://api.newegg.com/marketplace/reportmgmt/report/result?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "OperationType": "ItemBasicInfoReportRequest",
    "RequestBody": {
        "RequestID": "245VV9QOCM6BK"
    }
}

Response Body

Attribute Format Description
IsSuccess String Get feed status operation:

True: Successful
False: Not successful
SellerID String Your seller ID
OperationType String Fixed value: ItemBasicInfoReportResponse
RequestID String Newegg’s assigned ID for submitted request
RequestType String ITEM_BASIC_INFO_REPORT
RequestDate String Your request date time (Pacific Standard Time)
ReportFileURL String The ftp file path, where you can get the report result file, example:

ftp://KUXTMPPH:01250442@mktpftp.newegg.com/ApiItemBaseInfoReport_245VV9QOCM6BK.zip

File report property information: Please note for Newegg.com platform, only return USA of country code listing.

Property Name Definition
Seller Part # The seller part # is the SKU number assigned to this item by seller.
NE Item # The Newegg Item # for this item
Website Short Title Short, easily identifiable item name for this item, used as product title
Manufacturer Part# Manufacturer defined unique identifier for an item.

Note: once an item is created, this information cannot be updated.
UPC A unique Universal Product Code(UPC)(12 characters only) or European Articel Number (EAN)(13 characters only) for an item.

Note: once an item is created, this information cannot be updated.
Industry Category the item is falling into
SubCategory Subcategory the item is falling into
Bullet Description Concise descriptions of product features or functions which is listed by bullet point below the website short/long title on the product page
Item Length Item’s shipping length in inches, only value
Item Width Item’s shipping width in inches, only value
Item Height Item’s shipping height in inches, only value
Item Weight Item’s shipping weight in pounds, only value
Status Item’s current status, available value: default USA and CAN listings

  • Active
  • Inactive
Item Image Image URL for this item’s product original images, no more than 7
Date Created The time of item being created. Time format: MM/DD/YYYY
Platform On which platform the item is selling. Available value:

  • USA: Newegg.com
  • USB: Neweggbusienss.com
  • CAN: Newegg.ca

Schema: ItemBasicInfoReportResponse.xsd

Example: XML, Response

<NeweggAPIResponse>
   <IsSuccess>true</IsSuccess>
   <sellerID>A006</sellerID>
   <OperationType>ItemBasicInfoReportResponse</OperationType>
   <ResponseBody>
      <RequestID>245VV9QOCM6BK</RequestID>
      <RequestType>ITEM_BASIC_INFO_REPORT</RequestType>
      <RequestDate>2/21/2012 15:32:57</RequestDate>
      <ReportFileURL>ftp://KUXTMPPH:01250442@mktpftp.newegg.com/ApiItemBaseInfoReport_245VV9QOCM6BK.zip</ReportFileURL>
   </ResponseBody>
   <Memo />
</NeweggAPIResponse>

Example: Json, Response

{
  "NeweggAPIResponse": {
    "IsSuccess": "true",
    "sellerID": "A006",
    "OperationType": "ItemBasicInfoReportResponse",
    "ResponseBody": {
      "RequestID": "245VV9QOCM6BK",
      "RequestType": "ITEM_BASIC_INFO_REPORT",
      "RequestDate": "2/21/2012 15:32:57",
      "ReportFileURL": "ftp://KUXTMPPH:01250442@mktpftp.newegg.com/ApiItemBaseInfoReport_245VV9QOCM6BK.zip"
    },
    "Memo": null
  }
}

Request Failure Errors

For common HTTP error responses, please refer to Failed Response Error Code List.

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>CE001</Code>
        <Message>SellerID cannot be null or empty</Message>
    </Error>
</Errors>

Example: Json, Response

[
    {
        "Code": "CE001",
        "Message": "SellerID cannot be null or empty"
    }
]

Last updated: October 28, 2021