Get Item Lookup Report
Get a list of item’s if available in Newegg’s catalog.
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: ItemLookupRequest |
RequestID | Yes | String | Newegg’s assigned ID for submitted request |
PageIndex | Yes | Integer | Current page index |
PageSize | Yes | Integer | Return records count in one page
Max is 100 per page |
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>ItemLookupRequest</OperationType> <RequestBody> <RequestID>2PQBYWH4V68ZP</RequestID> <PageInfo> <PageIndex>1</PageIndex> <PageSize>10</PageSize> </PageInfo> </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": "ItemLookupRequest", "RequestBody": { "RequestID": "2PQBYWH4V68ZP", "PageInfo": { "PageSize": "10", "PageIndex": "1" } } }
Response Body
Attribute | Format | Description |
IsSuccess | String | Get feed status operation:
True: Successful |
SellerID | String | Your seller ID |
OperationType | String | Fixed value: ItemLookupResponse |
RequestID | String | Newegg’s assigned ID for submitted request |
RequestDate | String | Your request date time (Pacific Standard Time) |
TotalCount | Integer | Total number of records |
TotalPageCount | Integer | Total page count |
PageIndex | Integer | Current page index |
PageSize | Integer | How many records in a page |
SellerID | String | Seller ID |
NeweggItemNumber | String | Newegg’s assigned number for item |
UPC | String | UPC/EAN code for item |
Condition | String | Available values:
1: New Note: Used only available for Newegg.com |
PacksOrSets | Integer | Identify the package count of this product
Note: All products in a pack or set will have matching item and condition. |
ManufacturerName | Integer | Manufacture name of item |
ManufacturerPartNumber | String | Manufacture part number of item |
WebsiteShortTitle | String | Website short title of item |
Note | String | Error message for the request (e.g. No match found) |
ResponseDate | String | Response date (Pacific Standard Time) |
Schema: ItemLookupResponse.xsd
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?> <NeweggAPIResponse> <IsSuccess>true</IsSuccess> <OperationType>ItemLookupResponse</OperationType> <SellerID>bfwk</SellerID> <ResponseBody> <PageInfo> <TotalCount>4</TotalCount> <TotalPageCount>1</TotalPageCount> <PageIndex>1</PageIndex> <PageSize>10</PageSize> </PageInfo> <RequestID>28292T8ASAL64</RequestID> <RequestDate>07/11/2014 18:14:04</RequestDate> <ItemList> <Item> <ParentItemNumber>01T-001Y-00004</ParentItemNumber> <UPC>20140711101111</UPC> <Condition>1</Condition> <PacksOrSets>1</PacksOrSets> <ManufacturerName> <![CDATA[q-see ]]> </ManufacturerName> <ManufacturerPartNumber> <![CDATA[canmfpn20140711101 ]]> </ManufacturerPartNumber> <WebShortTitle> <![CDATA[b2b new item 201407111001 ]]> </WebShortTitle> </Item> <Item> <ParentItemNumber>01T-001Y-00004</ParentItemNumber> <UPC>20140711101111</UPC> <Condition>1</Condition> <PacksOrSets>1</PacksOrSets> <ManufacturerName> <![CDATA[q-see ]]> </ManufacturerName> <ManufacturerPartNumber> <![CDATA[canmfpn20140711101 ]]> </ManufacturerPartNumber> <WebShortTitle> <![CDATA[b2b new item 201407111001 ]]> </WebShortTitle> </Item> <Item> <ParentItemNumber>01T-001Y-00004</ParentItemNumber> <UPC>20140711101111</UPC> <Condition>1</Condition> <PacksOrSets>1</PacksOrSets> <ManufacturerName> <![CDATA[q-see ]]> </ManufacturerName> <ManufacturerPartNumber> <![CDATA[canmfpn20140711101 ]]> </ManufacturerPartNumber> <WebShortTitle> <![CDATA[b2b new item 201407111001 ]]> </WebShortTitle> </Item> <Item> <ParentItemNumber>01T-001Y-00007</ParentItemNumber> <UPC /> <Condition>2</Condition> <PacksOrSets>1</PacksOrSets> <ManufacturerName> <![CDATA[q-see ]]> </ManufacturerName> <ManufacturerPartNumber> <![CDATA[canmfpn20140711101 ]]> </ManufacturerPartNumber> <WebShortTitle> <![CDATA[456346 ]]> </WebShortTitle> </Item> </ItemList> </ResponseBody> <ResponseDate>07/11/2014 19:00:59</ResponseDate> </NeweggAPIResponse>
Example: Json, Response
{ "NeweggAPIResponse": { "IsSuccess": "true", "OperationType": "ItemLookupResponse", "SellerID": "bfwk", "ResponseBody": { "PageInfo": { "TotalCount": "4", "TotalPageCount": "1", "PageIndex": "1", "PageSize": "10" }, "RequestID": "28292T8ASAL64", "RequestDate": "07/11/2014 18:14:04", "ItemList": { "Item": [ { "ParentItemNumber": "01T-001Y-00004", "UPC": "20140711101111", "Condition": "1", "PacksOrSets": "1", "ManufacturerName": "q-see", "ManufacturerPartNumber": "canmfpn20140711101", "WebShortTitle": "b2b new item 201407111001" }, { "ParentItemNumber": "01T-001Y-00004", "UPC": "20140711101111", "Condition": "1", "PacksOrSets": "1", "ManufacturerName": "q-see", "ManufacturerPartNumber": "canmfpn20140711101", "WebShortTitle": "b2b new item 201407111001" }, { "ParentItemNumber": "01T-001Y-00004", "UPC": "20140711101111", "Condition": "1", "PacksOrSets": "1", "ManufacturerName": "q-see", "ManufacturerPartNumber": "canmfpn20140711101", "WebShortTitle": "b2b new item 201407111001" }, { "ParentItemNumber": "01T-001Y-00007", "UPC": "", "Condition": "2", "PacksOrSets": "1", "ManufacturerName": "q-see", "ManufacturerPartNumber": "canmfpn20140711101", "WebShortTitle": "456346" } ] } }, "ResponseDate": "07/11/2014 19:00:59" } }
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 15, 2018