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: International Country Guide
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