获取商品检索报告

请求获取新蛋类目下有效商品列表。

相关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}

注：请确保您的请求URL全都是小写（除Seller ID）并且不能包含任何空格或者换行符。

参数

名称 是否必填？ 描述
sellerid 是 您在新蛋商城的商家编号

相关请求信息

HTTP方式 是否需要认证？ 请求格式 回复格式 频率限制
PUT 需要 XML,Json XML,Json 500 请求/小时

请求文件主体

属性 是否必填？ 格式 描述
IssueUser 否 String 请求发送者在Seller Portal上注册过的邮箱地址 。

系统只接受商家注册过的Seller Portal邮箱地址。如果为空，默认值为商家编号
OperationType 是 String 固定值：ItemLookupRequest
RequestID 是 String 新蛋分配的已提交的请求的编号
PageIndex 是 Integer 当前页索引
PageSize 是 Integer 一页返回的记录总数

每页最多100条。

Schema: GetReportRequest.xsd

示例：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>

示例：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"
        }
    }
}

回复文件主体

属性 格式 描述
IsSuccess String 获取数据状态的操作：
True: 成功
False: 失败
SellerID String 您的商家编号
OperationType String 固定值：ItemLookupResponse
RequestID String 已提交的请求编号
RequestDate String 请求提交时间（太平洋标准时间）
TotalCount Integer 总记录数
TotalPageCount Integer 总页数
PageIndex Integer 当前页索引
PageSize Integer 一页的记录个数
SellerID String 您的商家编号
NeweggItemNumber String 新蛋商品编号
UPC String UPC 编码
Condition String 有效值：
1. New 全新的
2. Refurbished 翻新的
3. Used – Like New 二手-类似新品
4. Used – Very Good 二手-非常好
5. Used – Good 二手-好
6. Used – Acceptable 二手-尚可
注：二手Used只适用于Newegg.com
PacksOrSets Integer 定义该商品的封装数量
注：所有封装商品都会有匹配的商品和状态
ManufacturerName Integer 制造商名称
ManufacturerPartNumber String 制造商商品编号
WebsiteShortTitle String 商品短标题
Note String 请求的错误信息（例如：未找到匹配记录）
ResponseDate String 回复日期（太平洋标准时间）

Schema: ItemLookupResponse.xsd

示例：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>

示例：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"
    }
}

请求失败错误信息

常规HTTP错误回复，请参考回复失败错误代码列表。

示例：XML，Response

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

示例：Json，Response

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

更新日期：10/15/2018