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 |
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 |
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