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 | 30 requests per min per client |
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