Item Premier Mark Feed

Batch enroll/remove items for Premier program for participating sellers.

To participate in this program sellers must enroll in Newegg Shipping Label Service and Newegg  Premier Seller Program, go to Newegg Seller Portal > Add-on Services to enroll.

Resource URL

Newegg.com: https://api.newegg.com/marketplace/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_PREMIER_MARK_DATA

Resource Information

HTTP Method	Authentication?	Request Formats	Response Formats	Rate Limited?
POST	Required	XML, Json	XML, Json	Max. 100 requests per min per client

Note: Maximum Size of Request 10,000 records per file. Limit 30,000 records per hour.

Request Body

Attribute	Required?	Format	Description
DocumentVersion	Yes	Decimal	Fixed value: 1.0
MessageType	Yes	String	Fixed value: BatchPremierMarkUpdate
SellerPartNumber	Yes	String	The item’s seller part number. It will be used to identify the item for opt-in/out of program.
PremierMark	Yes	String	Available values: True: Enroll item for Premier program False: Remove item from Premier Program

Schema: PremierItemMark.xsd

Example: XML, Request

POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_PREMIER_MARK_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggEnvelope>
    <Header>
        <DocumentVersion>1.0</DocumentVersion>
    </Header>
    <MessageType>BatchPremierMarkUpdate</MessageType>
    <Message>
        <Item>
            <SellerPartNumber>JACKETEST0921001004</SellerPartNumber>
            <PremierMark>FALSE</PremierMark>
        </Item>
        <Item>
            <SellerPartNumber>JACKETEST0921001003</SellerPartNumber>
            <PremierMark>TRUE</PremierMark>
        </Item>
    </Message>
</NeweggEnvelope>

Example: Json, Request

POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_PREMIER_MARK_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "NeweggEnvelope": {
        "Header": {
            "DocumentVersion": "1.0"
        },
        "MessageType": "BatchPremierMarkUpdate",
        "Message": {
            "Item": [
                {
                    "SellerPartNumber": "JACKETEST0921001004",
                    "PremierMark": "FALSE"
                },
                {
                    "SellerPartNumber": "JACKETEST0921001003",
                    "PremierMark": "TRUE"
                }
            ]
        }
    }
}

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_PREMIER_MARK_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_PREMIER_MARK_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_PREMIER_MARK_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: October 15, 2018