Manufacturer Lookup for International Country

Query available manufacturer list on international country from Newegg.

Resource URL

Newegg.com: https://api.newegg.com/marketplace/contentmgmt/manufacturer/manufacturerinfo/V2?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 1000 request per hour

Request Body

Attribute Required? Format Description
OperationType Yes String Fixed value: GetManufacturerRequest
PageIndex No Integer Current page index

If left blank, will use 1 as default

PageSize No Integer Return records count in one page

(Max is 100 per page)

If left blank, will use 100 as default

RestrictedCountryCode Yes String The country where the manufacturer is being restricted to sell
Note: only the ISO standard 3-digit codes are accepted.  To review the complete list of available values, please download the following:

CreatedDateFrom No String Filter the manufacturers created after the date

Please refer to the Acceptable Date Format

CreatedDateTo No String Filter the manufacturers created before the date

Please refer to the Acceptable Date Format

ManufacturerName No String Manufacturer name

If left blank, will return all manufacturer names

Schema: GetManufacturerRequestV2.xsd

Example: XML, Request

PUT https://api.newegg.com/marketplace/contentmgmt/manufacturer/manufacturerinfo/v2?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggAPIRequest >
    <OperationType>GetManufacturerRequest</OperationType>
    <RequestBody>
        <PageIndex>1</PageIndex>
        <PageSize>10</PageSize>
        <RestrictedCountryCode>USA</RestrictedCountryCode>
        <RequestCriteria>
            <CreatedDateFrom>2013-08-30 14:20:00</CreatedDateFrom>
            <CreatedDateTo>2013-08-30 18:20:00</CreatedDateTo>
            <ManufacturerName>
                <![CDATA[sony & wonder]]>
            </ManufacturerName>
        </RequestCriteria>
    </RequestBody>
</NeweggAPIRequest>

Example: Json, Request

PUT https://api.newegg.com/marketplace/contentmgmt/manufacturer/manufacturerinfo/v2?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
        "OperationType": "GetManufacturerRequest",
        "RequestBody": {
            "PageIndex": "1",
            "PageSize": "10",
            "RestrictedCountryCode": "USA",
            "RequestCriteria": {
                "CreatedDateFrom": "2013-08-30 14:20:00",
                "CreatedDateTo": "2013-08-30 18:20:00",
                "ManufacturerName": "sony & wonder"
            }
        }
}

Response Body

Attribute Format Description
IsSuccess String Used to identify the operation of Manufacturer lookup is successful

Fixed value: True

SellerID String Your seller ID
OperationType String Fixed value: GetManufacturerResponse
ResponseDate String Response date
Memo String Additional messages
TotalCount Integer Total number of records
TotalPageCount Integer Total page count
PageIndex Integer Current page index
PageSize Integer How many records in a page.
Name String Manufacturer Name
IsRestricted Integer To identify the manufacturer is restricted or not.

  • 0: No
  • 1: Yes
CountryCode String The country where the manufacturer restriction is
being applied to.To review the complete list of available values, please download the following: International Country Guide
SubcategoryID Integer The subcategory ID which the restricted manufacturer applies on.

This will be empty if the manufacturer restricts for all subcategories.

SubcategoryName String The subcategory name which the restricted manufacturer applies on.

This will be empty if the manufacturer restricts for all subcategories.

MappedName String Mapped manufacturer name.
If you use this mapped name to create a new item, Newegg will map it to the existing manufacturer accordingly.
For example:
Manufacturer Name: SONY
Mapped name: Sony Ericsson Mobile, Sony Audio/Video, Sony PlayStation, Sony Creative Software, Sony Creative Software, Inc
If you use one of the Mapped name to create a new item, the manufacturer will be replaced with SONY.

Schema: GetManufacturerResponse.xsd

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <SellerID>A006</SellerID>
    <OperationType>GetManufacturerResponse</OperationType>
    <ResponseDate>2/22/2012 16:51:03</ResponseDate>
    <Memo />
    <ResponseBody>
        <PageInfo>
            <TotalCount>1</TotalCount>
            <TotalPageCount>1</TotalPageCount>
            <PageSize>10</PageSize>
            <PageIndex>1</PageIndex>
        </PageInfo>
        <ManufacturerList>
            <Manufacturer>
                <Name>
                    <![CDATA[sony & wonder]]>
                </Name>
                <IsRestricted>0</IsRestricted>
                <CountryCode>USA</CountryCode>
                <RestrictedSubcategoryList/>
                <MappedNameList>
                    <MappedName>wonder</MappedName>
                </MappedNameList>
            </Manufacturer>
            <Manufacturer>
                <Name>
                    <![CDATA[newegg]]>
                </Name>
                <IsRestricted>1</IsRestricted>
                <CountryCode>USA</CountryCode>
                <RestrictedSubcategoryList>
                    <Subcategory>
                        <SubcategoryID>1508</SubcategoryID>
                        <SubcategoryName>
                            <![CDATA[Belts & Suspenders]]>
                        </SubcategoryName>
                    </Subcategory>
                    <Subcategory>
                        <SubcategoryID>153</SubcategoryID>
                        <SubcategoryName>
                            <![CDATA[Buckles]]>
                        </SubcategoryName>
                    </Subcategory>
                </RestrictedSubcategoryList>
                <MappedNameList>
                    <MappedName>test_newegg</MappedName>
                </MappedNameList>
            </Manufacturer>
        </ManufacturerList>
    </ResponseBody>
</NeweggAPIResponse>

Example: Json, Response

{
  "NeweggAPIResponse": {
    "IsSuccess": "true",
    "SellerID": "A006",
    "OperationType": "GetManufacturerResponse",
    "ResponseDate": "2/22/2012 16:51:03",
    "ResponseBody": {
      "PageInfo": {
        "TotalCount": "1",
        "TotalPageCount": "1",
        "PageSize": "10",
        "PageIndex": "1"
      },
      "ManufacturerList": {
        "Manufacturer": [
          {
            "Name": "sony & wonder",
            "IsRestricted": "0",
            "CountryCode": "USA",
            "MappedNameList": { "MappedName": "wonder" }
          },
          {
            "Name": "newegg",
            "IsRestricted": "1",
            "CountryCode": "USA",
            "RestrictedSubcategoryList": {
              "Subcategory": [
                {
                  "SubcategoryID": "1508",
                  "SubcategoryName": "Belts & Suspenders"
                },
                {
                  "SubcategoryID": "153",
                  "SubcategoryName": "Buckles"
                }
              ]
            },
            "MappedNameList": { "MappedName": "test_newegg" }
          }
        ]
      }
    }
  }
}

Request Failure Errors
For common HTTP error responses, please refer to Failed Response Error Code List.

Error Code Description
CT033 Invalid manufacturer name :{0}.

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>CT033</Code>
        <Message>Invalid manufacturer name: Joe Machine</Message>
    </Error>
</Errors>

Example: Json, Response

[
    {
        "Code": "CT033",
        "Message": "Invalid manufacturer name: Joe Machine"
    }
]

Last updated: October 15, 2018