Get Subcategory Property Values

Get the subcategory property value for the specified property.

Resource URL

Newegg.com: https://api.newegg.com/marketplace/sellermgmt/seller/propertyvalue?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/sellermgmt/seller/propertyvalue?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/sellermgmt/seller/propertyvalue?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 100 request per hour

Request Body

Attribute Required? Format Description
OperationType Yes String Fixed values: GetSellerPropertyValueRequest
SubcategoryID No Integer Newegg Subcategory ID

Note:

  • Obtained using the Get Subcategory Status request
  • If left blank, returns the property information for all applied subcategories
PropertyName Yes String Newegg Property Name

Note: Obtained using the Get Subcategory Properties request

Schema: GetSubcategoryPropertyValueRequest.xsd

Example: XML, Request

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

<NeweggAPIRequest>
    <OperationType>GetSellerPropertyValueRequest</OperationType>
    <RequestBody>
        <SubcategoryID>1045</SubcategoryID>
        <PropertyName>Costume_Gender</PropertyName>
    </RequestBody>
</NeweggAPIRequest>

Example: Json, Request

PUT https://api.newegg.com/marketplace/sellermgmt/seller/propertyvalue?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
    "OperationType": "GetSellerPropertyValueRequest",
    "RequestBody": {
        "SubcategoryID": "1045",
        "PropertyName": "Costume_Gender"
    }
}

Response Body

Attribute Format Description
IsSuccess String Get feed status operation:

  • True: Successful
  • False: Not successful
OperationType String Fixed value: GetSellerPropertyValueResponse
SellerID String Your seller ID
SubcategoryID Integer Newegg subcategory ID
SubcategoryName String Newegg subcategory name
PropertyName String Property name of specified Newegg subcategory
IsAdvancedSearch Integer Will this property be showing up in the advance search navigation?
Available values:

  • 0: No
  • 1: Yes
IsGroupBy Integer Is this a group by property?
Available values:

  • 0: No
  • 1: Yes
IsRequired Integer Is this a required property?
Available values:

  • 0: No
  • 1: Yes
PropertyValue String Property value

Schema: GetSubcategoryPropertyValueResponse.xsd

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>GetSellerPropertyValueResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseBody>
        <PropertyInfoList>
            <PropertyInfo>
                <SubcategoryID>1045</SubcategoryID>
                <SubcategoryName>
                    <![CDATA[Costume]]>
                </SubcategoryName>
                <PropertyName>
                    <![CDATA[Costume_Gender]]>
                </PropertyName>
                <IsAdvancedSearch>1</IsAdvancedSearch>
                <IsGroupBy>0</IsGroupBy>
                <IsRequired>0</IsRequired>
                <PropertyValueList>
                    <PropertyValue>
                        <![CDATA[Male]]>
                    </PropertyValue>
                </PropertyValueList>
            </PropertyInfo>
            <PropertyInfo>
                <SubcategoryID>1045</SubcategoryID>
                <SubcategoryName>
                    <![CDATA[Costume]]>
                </SubcategoryName>
                <PropertyName>
                    <![CDATA[Costume_Gender]]>
                </PropertyName>
                <IsAdvancedSearch>1</IsAdvancedSearch>
                <IsGroupBy>0</IsGroupBy>
                <IsRequired>0</IsRequired>
                <PropertyValueList>
                    <PropertyValue>
                        <![CDATA[Female]]>
                    </PropertyValue>
                </PropertyValueList>
            </PropertyInfo>
            <PropertyInfo>
                <SubcategoryID>1045</SubcategoryID>
                <SubcategoryName>
                    <![CDATA[Costume]]>
                </SubcategoryName>
                <PropertyName>
                    <![CDATA[Costume_Gender]]>
                </PropertyName>
                <IsAdvancedSearch>1</IsAdvancedSearch>
                <IsGroupBy>0</IsGroupBy>
                <IsRequired>0</IsRequired>
                <PropertyValueList>
                    <PropertyValue>
                        <![CDATA[Unisex]]>
                    </PropertyValue>
                </PropertyValueList>
            </PropertyInfo>
        </PropertyInfoList>
    </ResponseBody>
</NeweggAPIResponse>

Example: Json, Response

{
    "IsSuccess": "true",
    "OperationType": "GetSellerPropertyValueResponse",
    "SellerID": "A006",
    "ResponseBody": {
        "PropertyInfoList": [
            {
                "SubcategoryID": "1045",
                "SubcategoryName": "Costume",
                "PropertyName": "Costume_Gender",
                "IsAdvancedSearch": "1",
                "IsGroupBy": "0",
                "IsRequired": "0",
                "PropertyValueList": [
                    "Male"
                ]
            },
            {
                "SubcategoryID": "1045",
                "SubcategoryName": "Costume",
                "PropertyName": "Costume_Gender",
                "IsAdvancedSearch": "1",
                "IsGroupBy": "0",
                "IsRequired": "0",
                "PropertyValueList": [
                    "Female"
                ]
            },
            {
                "SubcategoryID": "1045",
                "SubcategoryName": "Costume",
                "PropertyName": "Costume_Gender",
                "IsAdvancedSearch": "1",
                "IsGroupBy": "0",
                "IsRequired": "0",
                "PropertyValueList": [
                    "Unisex"
                ]
            }
        ]
    }
}

Request Failure Errors

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

Error Code Description
DF009 Invalid subcategory ID [{0}].

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>DF009</Code>
        <Message>Invalid subcategory ID ABC</Message>
    </Error>
</Errors>

Example: Json, Response

[
    {
        "Code": "DF008",
        "Message": "Invalid industry code ABC"
    }
]

Last updated: October 15, 2018