eBay Trading APIVersion 1235

• Home
• All Docs
• Support
• Knowledge Base
• Forums
• Resources

• Features Guide
• Users Guide
• Making a Call
• API Reference
• Tutorials
• Release Notes

GetCategorySpecifics

Note: The GetCategorySpecifics call is being deprecated. No new features and/or fields will be added to GetCategorySpecifics, and it will no longer be supported after April 20, 2022. eBay recommends that large sellers and developers migrate to the Taxonomy API RESTful methods.

Use this call to retrieve all mandatory/recommended Item Specific name-value pairs for specified listing categories. The number of mandatory/recommended Item Specifics name-value pairs will vary by category, and the user also has the option of restricting the number of Item Specifics names and corresponding values that are returned by using the MaxNames and/or MaxValuesPerName filters in the request payload.

Note: In October 2019, eBay has updated the GetCategorySpecifics call to retrieve all available Item Specifics name-value pairs for each specified category by default. Previously, 30 Item Specifics names would be returned by default (if the MaxNames filter wasn't used) and 25 corresponding Item Specifics values would be returned by default (if the MaxValuesPerName filter wasn't used). However, if a user wants to limit the number of Item Specifics names and corresponding values that are returned, they can still use the MaxNames and/or MaxValuesPerName filters to do this.

Usage Details

Item Specifics are name-value pairs that describe typical aspects of items. They enable sellers to present descriptive details of an item in a structured way. For example, in a jewelry category, you might describe a locket using "Gemstone=Amber" (where "Gemstone" is the name and "Amber" is the value), and in a Washers & Dryers category, you might use "Type=Top-Loading".

For each category, required Item Specifics are returned first in the GetCategorySpecifics response, followed by recommended Item Specifics, and then by optional Item Specifics. Each Item Specific will be accompanied by a list of possible values.

Item Specifics Recommendations in eBay Listings

When you are listing an item, eBay recommends that you consider using as many recommended Item Specifics and relevant optional Item Specifics as possible, so that buyers (and comparison shopping tools) completely understand the details of your item.

The names and values returned in GetCategorySpecifics are more likely to be indexed for title and description searches in the future. If you don't see a Item Specific name and/or value that applies to your item, you can add your own custom names and values in your listing request.

Downloading Item Specifics for Multiple Categories

A user can retrieve Item Specifics for up to 100 categories at a time. If retrieve data for more than 100 categories, GetCategorySpecifics will have to be called multiple times.

For applications that support a vast amount of categories, it may be more practical to use the downloadFile call in the File Transfer API to download a single GetCategorySpecifics response that contains Item Specific metadata for all categories on a given eBay marketplace. This GetCategorySpecifics response (with metadata for all categories on a site) is returned as a .zip file attachment in the downloadFile call.

Here's a typical way to use this approach:

1. In the Trading API, call GetCategorySpecifics for a particular site (e.g., site ID 0), include the CategorySpecificsFileInfo boolean field in the request, and set its value to 'true'.
   The GetCategorySpecifics response will include a FileReferenceID value and a TaskReferenceID value. Capture these values.
2. Pass the FileReferenceID and TaskReferenceID values into the downloadFile call request (a call in the File Transfer API).
   If successful, the downloadFile response will return a standard "Success" response, plus a .zip file.
3. Extract the .zip file to view Item Specifics metadata for all categories on an eBay site.
4. Periodically (maybe every day or two), call GetCategorySpecifics again (with CategorySpecificsFileInfo=true to see if the FileReferenceID and TaskReferenceID values have changed. If they have changed, use the downloadFile call again, passing in the new IDs to download the latest version of the file.

The downloadable GetCategorySpecifics response file is updated every few days. When this occurs, eBay generates new file reference and task reference IDs for the new file. A different file (with different IDs) is associated with each eBay site.

Note: You don't need to learn about (or use) Large Merchant Services or the Bulk Data Exchange API in order to use the downloadFile call in the File Transfer API.

If you call GetCategoryFeatures, you may detect new Item Specifics names and values that have been newly enabled in certain categories since you last downloaded recommendations. In this case, if the file IDs returned by GetCategorySpecifics haven't changed, you can call GetCategorySpecifics directly to retrieve any new recommendations for those specific categories.

Each time you call GetCategorySpecifics, store the response data locally and use that data to fill in recommendations for a listing. Periodically (once a day or weekly, depending on your use case), check to see if the data has changed.

The downloadFile call in the File Transfer API supports both SOAP and XML requests and responses. However, the GetCategorySpecifics response in the .zip file is formatted as an XML-style response (without the SOAP envelope). If your application requires the response in a a SOAP envelope, you can insert it like this (the inserted portion is in bold):

<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Body>
    <GetCategorySpecificsResponse xmlns="urn:ebay:apis:eBLBaseComponents">
      <Timestamp>2018-11-28T22:51:57.426Z</Timestamp>
      <Ack>Success</Ack>
      <Version>1085</Version>
      <Build>E1085_CORE_API6_18863791_R1</Build>
      <!-- ... etc. ... -->
    </GetCategorySpecificsResponse>
  </soapenv:Body>
</soapenv:Envelope>

Input Output Detail Controls Samples Change History

Input

See also Samples.

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are (or soon will be) non-operational.

The XML prototype does not include requester credentials. This is a documentation limitation only (see Standard Requester Credentials for Making Calls).

<?xml version="1.0" encoding="utf-8"?>
<GetCategorySpecificsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <CategoryID> string </CategoryID>
  <!-- ... more CategoryID values allowed here ... -->
  <CategorySpecific> CategoryItemSpecificsType
    <CategoryID> string </CategoryID>
    <!-- ... more CategoryID values allowed here ... -->
    <ItemSpecifics> NameValueListArrayType
      <NameValueList> NameValueListType
        <Name> string </Name>
        <Value> string </Value>
        <!-- ... more Value values allowed here ... -->
      </NameValueList>
      <!-- ... more NameValueList nodes allowed here ... -->
    </ItemSpecifics>
  </CategorySpecific>
  <!-- ... more CategorySpecific nodes allowed here ... -->
  <CategorySpecificsFileInfo> boolean </CategorySpecificsFileInfo>
  <ExcludeRelationships> boolean </ExcludeRelationships>
  <IncludeConfidence> boolean </IncludeConfidence>
  <LastUpdateTime> dateTime </LastUpdateTime>
  <MaxNames> int </MaxNames>
  <MaxValuesPerName> int </MaxValuesPerName>
  <Name> string </Name>
  <!-- Standard Input Fields -->
  <ErrorLanguage> string </ErrorLanguage>
  <MessageID> string </MessageID>
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
</GetCategorySpecificsRequest>

Argument	Type	Occurrence	Meaning

Call-specific Input Fields [Jump to standard fields]

CategoryID	string	Conditional, repeatable: [0..100]	A unique identifer for an eBay category. Recommended Item Specifics names and values will be retrieved for each eBay category that is specified. Up to 100 CategoryID values may be specified in one call. Although Item Specifics metadata can be retrieved for any eBay category at any level in the hierarchy, it is recommended that users specify leaf category IDs, especially if they are using GetCategorySpecifics to retrieve the Item Specifics applicable to the listing categories they use. A GetCategorySpecifics call request requires at least one of the following: a CategoryID value, a CategorySpecifics.CategoryID value, or the CategorySpecificsFileInfo field with its value set to true. CategoryID values and CategorySpecific.CategoryID values can both be used in the same request. Keep in mind that a high number of specified categories can result in longer response times and larger result sets. If your call request happens to time out, you might want specify fewer categories. If any CategoryID values are specified more than once, only the first instance will be used.
CategorySpecific	CategoryItemSpecificsType	Conditional, repeatable: [0..275]	This container can be used instead of, or in conjunction with CategoryID values specified at the call request root level. The CategorySpecific container can actually be more powerful since you can pass in multiple Category ID and Item Specifics name combinations, and if you specify CategoryID values at the root level, only one (Item Specifics) Name value can be used. A GetCategorySpecifics call request requires at least one of the following: a CategoryID value, a CategorySpecifics.CategoryID value, or the CategorySpecificsFileInfo field with its value set to true. CategoryID values and CategorySpecific.CategoryID values can both be used in the same request. Keep in mind that a high number of specified categories can result in longer response times and larger result sets. If your call request happens to time out, you might want specify fewer categories. If any CategorySpecifics.CategoryID values are specified more than once, only the first instance will be used.
CategorySpecific.CategoryID	string	Conditional, repeatable: [0..100]	An eBay category ID is passed into this field to identify the eBay category for which the seller is providing Item Specific name-value(s) pairs. Multiple CategoryID fields can be passed in if the Item Specific name-value(s) pairs are applicable for multiple categories. However, more categories can result in longer call response times. If your request times out, specify fewer category IDs. Note: The call request requires either one or more CategoryID values (at the root level), one or more CategorySpecific.CategoryID values, or the CategorySpecificsFileInfo boolean field. The CategorySpecificsFileInfo field is only used if the user plans to use the downloadFile call of the FileTransfer API to retrieve Item Specifics. CategoryID and CategorySpecific.CategoryID can both be used in the same call request. Max length: 10.
CategorySpecific.ItemSpecifics	NameValueListArrayType	Conditional	This container is used to input Item Specific name-value(s) pairs for a specific category to discover if eBay has better name or value recommendations for that Item Specific. The Item Specific name can be an arbitrary name that the user wants to check, or it could be a name that was returned in a prior GetCategorySpecifics response. At least one NameValueList container must be used if the CategorySpecific container is used.
CategorySpecific.ItemSpecifics   .NameValueList	NameValueListType	Conditional, repeatable: [0..*]	For the AddItem family of calls: Contains the name and value(s) for an Item Specific. Only required when the ItemSpecifics container is specified. Note: The maximum number of item specifics that may be defined for a listing has increased from 30 to 45. For the AddFixedPriceItem family of calls: The same NameValueList schema is used for the ItemSpecifics node, the VariationSpecifics node, and the VariationSpecifcsSet node. If the listing has variations, any name that you use in the VariationSpecifics and VariationSpecificsSet nodes can't be used in the ItemSpecifics node. When you list with Item Variations: Specify shared Item Specifics (e.g., Brand) in the ItemSpecifics node. Specify up to five VariationSpecifics in each Variation node. Specify all applicable names with all their supported values in the VariationSpecificSet node. See the Variation sample in the AddFixedPriceItem call reference for examples. For PlaceOffer: Required if the item being purchased includes Item Variations. For AddToWatchList and RemoveFromWatchList: The ItemID value of the multiple-variation listing and the name-value pair to identify each variation in the listing are required. Note: As of August 30, 2018, California will require sellers to display a Proposition 65 warning on online retail sites if products contain chemicals and/or substances that may impact the health of California buyers. This requirement is applicable to most eBay US categories, including eBay Motors, Motors Parts & Accessories, and catalog-enabled categories. The warning message can be customized by the seller, but should contain the following basic information: The name of at least one listed chemical that prompted the warning Text stating that the product 'can expose you to' the chemical(s) in the product The URL for OEHHA's new Proposition 65 warnings website, which is www.P65Warnings.ca.gov Unlike standard item specifics that allow a maximum of 65 characters in the Value field, the matching value for the 'California Prop 65 Warning' item specific allows up to 800 characters of text. When a seller passes in this item specific, eBay will automatically insert a warning symbol icon for the listing.
CategorySpecific.ItemSpecifics   .NameValueList.Name	string	Conditional	Depending on the call and context, this value is either a name of an Item/Category/Variation Specific, or a Parts Compatibility name. For the AddItem and AddFixedPriceItem families of calls: In the Item.ItemSpecifics context, this can be any name that the seller wants to use. However, to help buyers find items more easily, it is a good idea to try to use a recommended name when possible (see GetCategorySpecifics). You can't specify the same name twice within the same listing. For the AddFixedPriceItem family of calls: In the VariationSpecifics context, this can be any name that the seller wants to use, unless the VariationsEnabled flag is false for the name in the GetCategorySpecifics response. For example, for some categories eBay may recommend that you only use "Brand" as a shared name at the Item level, not in variations. For the AddFixedPriceItem family of calls: In the Compatibility.NameValueList context, this value is a motor vehicle aspect such as Year, Make, and Model. A Compatibility.NameValueList container is applicable for motor vehicle parts and accessories listings. For GetCategorySpecifics: This is a recommended (popular) name to use for items in the specified category (e.g., "Brand" might be recommended, not "Manufacturer"). For PlaceOffer: Required if the item being purchased includes Item Variations. Note: For mandatory and recommended item specifics that are returned in the GetCategorySpecifics call, the seller should pass in the name of these item specifics just as they are shown in the GetCategorySpecifics response. Similarly, for catalog-enabled categories, the seller should pass in the name of instance aspects just as they are shown in the GetCategorySpecifics response. Instance aspects are additional details unique to a specific item or listing that a seller can include along with the product aspects that are already defined in the eBay catalog product associated with the listing. Instance aspects common to many catalog-enabled categories include 'Bundle Description' and 'Modification Description'. As of August 30, 2018, eBay US sellers who ship to California are required to pass in a 'California Prop 65 Warning' item specific if the item in the listing contains one or more chemicals known to be harmful to human health. This item specific is passed at the listing level for both single-variation and multiple-variation listings. The 'California Prop 65 Warning' is considered an instance specific because it will be retained on the listing even when the seller lists using an eBay catalog product. The 'California Prop 65 Warning' may be applicable in most eBay US categories, including eBay Motors, Motors Parts & Accessories, and catalog-enabled categories. Note: If Brand and MPN (Manufacturer Part Number) are being used to identify product variations in a multiple-variation listing, the Brand must be specified at the item level (ItemSpecifics container) and the MPN for each product variation must be specified at the variation level (VariationSpecifics container). The Brand name must be the same for all variations within a single listing. Max length: 65.
CategorySpecific.ItemSpecifics   .NameValueList.Value	string	Conditional, repeatable: [0..*]	Depending on the call and context, this value is either the value of an Item/Category/Variation Specific, a Parts Compatibility value, or a product identifier. For the AddItem family of calls: If you specify multiple values for Item Specifics, eBay only stores the first one, unless GetCategorySpecifics indicates that the corresponding name supports multiple values. For the AddFixedPriceItem family of calls: If you specify multiple values for Item Specifics or Variation Specifics, eBay only stores the first one, unless GetCategorySpecifics indicates that the corresponding name supports multiple values. In VariationSpecificSet, you typically specify multiple Value fields for each name. For example, if Name = Size, you would specify all size values that you wan to offer in the listing. For the Compatibility.NameValueList context, this is the corresponding value of a motor vehicle aspect such as Year, Make, and Model. A Compatibility.NameValueList container is applicable for motor vehicle parts and accessories listings. For GetCategorySpecifics: The most highly recommended values are returned first. For these calls, Value is only returned when recommended values are available. For PlaceOffer: Required if the item being purchased includes Item Variations. Note: The standard maximum length for the value of an item specific is 65, but the maximum allowed length increases for instance aspects such as 'Bundle Description' and 'Modification Description'. The maximum allowed length for these instance aspects are returned in the GetCategorySpecifics call. The maximum allowed length for the new 'California Prop 65 Warning' item specific is 800 characters. For more information about the 'California Prop 65 Warning' item specific, see the ItemSpecifics.NameValueList field description. Max length: 65 (but longer for some instance aspects, including 800 for 'California Prop 65 Warning').
CategorySpecificsFileInfo	boolean	Conditional	If this boolean field is included and set to true, the response includes a FileReferenceID and TaskReferenceID value. Use these identifiers as inputs to the downloadFile call in the eBay File Transfer API. That API lets you retrieve a single (bulk) GetCategorySpecifics response with all the Item Specifics recommendations available for the requested site ID. (The downloadFile call downloads a .zip file as an attachment.) Either the CategorySpecificsFileInfo field or one or more CategoryID and/or CategorySpecific.CategoryID values are required in a GetCategorySpecifics call. Note: You can use the File Transfer API without using or learning about the Bulk Data Exchange API or other Large Merchant Services APIs. See downloadFile in the File Transfer API.
ExcludeRelationships	boolean	Optional	If this boolean field is included and set to true, the Relationship container will not be returned for any Item Specifics name or value recommendations. Relationship recommendations tell you whether an Item Specific has a logical dependency another Item Specific. For example, in a clothing category, Size Type could be recommended as a parent of Size, because Size=Small would mean something different to buyers depending on whether Size Type=Petite or Size Type=Plus. In general, it is a good idea to retrieve and use relationship recommendations, as this data can help buyers find the items they want more easily. Default: false.
IncludeConfidence	boolean	Optional	If this boolean field is included and set to true, eBay's level of confidence in the popularity of each Item Specific name and value for the specified category is returned in the response. Some sellers may find this useful when choosing whether to use eBay's recommendation or their own Item Specifics names or values. If this field is used, either one or more CategoryID values and/or one or more CategorySpecific.CategoryID values must be specified. If you try to use this field solely with the CategorySpecificsFileInfo field, the request fails and no TaskReferenceID or FileReferenceID values are returned. Default: false.
LastUpdateTime	dateTime	Conditional	This dateTime filter can be included and used if the user only wants to check for recently-added Item Specifics names and values for one or more categories. If this filter is used, the Item Specifics recommendation engine will only check for Item Specifics names and values that have been added/changed since the date that was passed in to this field. If this field is used, the call will not return any Item Specifics data; it will only return the Recommendations.Updated boolean field for each specified eBay category. A true value in this field will indicate that the recommended Item Specifics names/values for the eBay category have changed since the timestamp passed in the LastUpdateTime field, and a false value in this field will indicate that the recommended Item Specifics names/values for the eBay category have not changed since the timestamp passed in the LastUpdateTime field. Typically, you will pass in the timestamp value that was returned the last time you refreshed the list of Item Specifics names and values for the same categories. If the Recommendations.Updated flag returns true for any eBay categories in the response, you will want to call GetCategorySpecifics again for those eBay categories to get the latest names and values. As downloading all the data may affect your application's performance, it may help to only download Item Specifics data for an eBay category if the data has changed since you last checked.
MaxNames	int	Optional	This field can be used if you want to control the number of Item Specifics that are returned for each specified eBay category. If you only wanted to retrieve the 10 most popular Item Specifics per category, you would include this field and set its value to 10. Note that mandatory Item Specifics are always returned first in the response. If this field is omitted, all available Item Specifics names for each specified category are returned. If this field's value is set to a value that is higher than the number of Item Specific names available, all Item Specific names are still returned. Note: In October 2019, eBay updated the GetCategorySpecifics call to retrieve all available Item Specifics name-value pairs for each specified category by default. Previously, 30 Item Specifics names would be returned by default (if the MaxNames filter wasn't used) and 25 corresponding Item Specifics values would be returned by default (if the MaxValuesPerName filter wasn't used). However, if a user wants to limit the number of Item Specifics names and corresponding values that are returned, they can still use the MaxNames and/or MaxValuesPerName filters to do this. Min: 1.
MaxValuesPerName	int	Optional	This field can be used if you want to control the number of corresponding values that are returned for each returned Item Specific name in each specified eBay category. If you only wanted to retrieve the 10 most popular values/options for each returned Item Specific name in each category, you would include this field and set its value to 10. If this field is omitted, all available values for the corresponding Item Specifics name for each category are returned. If this field's value is set to a value that is higher than the number of Item Specific values available for any Item Specific name, all Item Specific values are still returned. Note: In October 2019, eBay has updated the GetCategorySpecifics call to retrieve all available Item Specifics name-value pairs for each specified category by default. Previously, 30 Item Specifics names would be returned by default (if the MaxNames filter wasn't used) and 25 corresponding Item Specifics values would be returned by default (if the MaxValuesPerName filter wasn't used). However, if a user wants to limit the number of Item Specifics names and corresponding values that are returned, they can still use the MaxNames and/or MaxValuesPerName filters to do this. Min: 1.
Name	string	Optional	This field can be used if you already have an Item Specific name in mind, and you only want the recommended values for this Item Specifics name. If you specify multiple eBay categories in the request, the recommendation engine may find a matching Item Specifics name for some categories, but not for others. For eBay categories where the Item Specifics name is not found, recommended Item Specifics names and values will be returned. The Item Specifics name passed in this field is case-sensitive, and wildcards are not supported. Max length: 30.

Standard Input Fields

ErrorLanguage	string	Optional	Use ErrorLanguage to return error strings for the call in a different language from the language commonly associated with the site that the requesting user is registered with. Below are some examples from different countries. ID Country en_AU Australia de_AT Austria nl_BE Belgium (Dutch) fr_BE Belgium (French) en_CA Canada fr_CA Canada (French) zh_CN China fr_FR France de_DE Germany zh_HK Hong Kong en_IN India en_IE Ireland it_IT Italy nl_NL Netherlands en_SG Singapore es_ES Spain de_CH Switzerland en_GB United Kingdom en_US United States
MessageID	string	Optional	Most Trading API calls support a MessageID element in the request and a CorrelationID element in the response. If you pass in a MessageID in a request, the same value will be returned in the CorrelationID field in the response. Pairing these values can help you track and confirm that a response is returned for every request and to match specific responses to specific requests. If you do not pass a MessageID value in the request, CorrelationID is not returned. Note: GetCategories is designed to retrieve very large sets of metadata that change once a day or less often. To improve performance, these calls return cached responses when you request all available data (with no filters). When this occurs, the MessageID and CorrelationID fields aren't applicable. However, if you specify an input filter to reduce the amount of data returned, the calls retrieve the latest data (not cached). When this occurs, MessageID and CorrelationID are applicable.
Version	string	Conditional	The version number of the API code that you are programming against (e.g., 1149). The version you specify for a call has these basic effects: It indicates the version of the code lists and other data that eBay should use to process your request. It indicates the schema version you are using. You need to use a version that is greater than or equal to the lowest supported version. For the SOAP API: If you are using the SOAP API, this field is required. Specify the version of the WSDL your application is using. For the XML API: If you are using the XML API, this field has no effect. Instead, specify the version in the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header. (If you specify Version in the body of an XML API request and it is different from the value in the HTTP header, eBay returns an informational warning that the value in the HTTP header was used instead.) See:     HTTP Headers     eBay Schema Versioning Strategy     Lowest Supported Version
WarningLevel	WarningLevelCodeType	Optional	Controls whether or not to return warnings when the application passes unrecognized or deprecated elements in a request. An unrecognized element is one that is not defined in any supported version of the schema. Schema element names are case-sensitive, so using WarningLevel can also help you remove any potential hidden bugs within your application due to incorrect case or spelling in field names before you put your application into the Production environment. WarningLevel only validates elements; it doesn't validate XML attributes. It also doesn't control warnings related to user-entered strings or numbers, or warnings for logical errors. We recommend that you only use this during development and debugging. Do not use this in requests performed in the Production environment. Applicable values: High (in) The WarningLevel value is set to High if the user wishes to receive warnings when the application passes unrecognized or deprecated elements in an API call request. Setting the WarningLevel value to High is not recommended in a production environment. Instead, it should only be used during the development/debugging stage. Low (in) The WarningLevel value is set to Low if the user does not wish to receive warnings when the application passes unrecognized or deprecated elements in an API call request. This is the default value if WarningLevel is not specified in the call request. See Warning Level.

Input Output Detail Controls Samples Change History

Output

See also Samples.

The box below lists all fields that might be returned in the response. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are not returned (or soon will not be returned) or are not operational (or soon will be non-operational).

<?xml version="1.0" encoding="utf-8"?>
<GetCategorySpecificsResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <FileReferenceID> string </FileReferenceID>
  <Recommendations> RecommendationsType
    <CategoryID> string </CategoryID>
    <NameRecommendation> NameRecommendationType
      <HelpText> string </HelpText>
      <HelpURL> anyURI </HelpURL>
      <Name> string </Name>
      <RelevanceIndicator> RelevanceIndicatorType
        <SearchCount> long </SearchCount>
      </RelevanceIndicator>
      <ValidationRules> RecommendationValidationRulesType
        <AspectUsage> AspectUsageCodeType </AspectUsage>
        <Confidence> int </Confidence>
        <MaxValueLength> int </MaxValueLength>
        <MaxValues> int </MaxValues>
        <MinValues> int </MinValues>
        <Relationship> NameValueRelationshipType
          <ParentName> string </ParentName>
        </Relationship>
        <!-- ... more Relationship nodes allowed here ... -->
        <SelectionMode> SelectionModeCodeType </SelectionMode>
        <UsageConstraint> UsageConstraintCodeType </UsageConstraint>
        <ValueFormat> ValueFormatCodeType </ValueFormat>
        <ValueType> ValueTypeCodeType </ValueType>
        <VariationPicture> VariationPictureRuleCodeType </VariationPicture>
        <VariationSpecifics> VariationSpecificsRuleCodeType </VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation> ValueRecommendationType
        <ValidationRules> RecommendationValidationRulesType
          <Confidence> int </Confidence>
          <ProductRequired> ProductRequiredCodeType </ProductRequired>
          <Relationship> NameValueRelationshipType
            <ParentName> string </ParentName>
            <ParentValue> string </ParentValue>
          </Relationship>
          <!-- ... more Relationship nodes allowed here ... -->
        </ValidationRules>
        <Value> string </Value>
      </ValueRecommendation>
      <!-- ... more ValueRecommendation nodes allowed here ... -->
    </NameRecommendation>
    <!-- ... more NameRecommendation nodes allowed here ... -->
    <Updated> boolean </Updated>
  </Recommendations>
  <!-- ... more Recommendations nodes allowed here ... -->
  <TaskReferenceID> string </TaskReferenceID>
  <!-- Standard Output Fields -->
  <Ack> AckCodeType </Ack>
  <Build> string </Build>
  <CorrelationID> string </CorrelationID>
  <Errors> ErrorType
    <ErrorClassification> ErrorClassificationCodeType </ErrorClassification>
    <ErrorCode> token </ErrorCode>
    <ErrorParameters ParamID="string"> ErrorParameterType
      <Value> string </Value>
    </ErrorParameters>
    <!-- ... more ErrorParameters nodes allowed here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes allowed here ... -->
  <HardExpirationWarning> string </HardExpirationWarning>
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
</GetCategorySpecificsResponse>

Return Value	Type	Occurrence	Meaning

Call-specific Output Fields [Jump to standard fields]

FileReferenceID	string	Conditionally	A TaskReferenceID and a FileReferenceID value are returned if the CategorySpecificsFileInfo field is included in the call request and set to true. These values will be used as inputs in the downloadFile call of the File Transfer API. That API lets you retrieve a single (bulk) GetCategorySpecifics response with all the Item Specifics recommendations available for the requested site ID. (The downloadFile call downloads a .zip file as an attachment.) See downloadFile in the File Transfer API.
Recommendations	RecommendationsType	Conditionally, repeatable: [0..275]	This container provide details about relevant Item Specifics for the specified category. Required Item Specifics are generally returned at the top of the response payload, followed by the other most common/popular Item Specifics for the category. If an Item Specific is required, a MinValues field will be returned with a value of 1, and the corresponding UsageConstraint field will show a value of Required. Optional Item Specifics are returned after required and recommended Item Specifics, but sellers should still provide any optional Item Specific name-value pairs if known and relevant for the product. As mentioned above, the most relevant Item Specifics are returned first, and similarly, if an Item Specific has multiple suggested values, these values are sorted according to popularity (most popular to less popular/common). This node returns empty (or it's not returned) for a category if there is no applicable data (such as when you request a parent category, a category that has no popular Item Specifics yet, or a duplicate category that was already returned). If you pass in the CategoryID and Name fields together, but no matching values are found for the name, eBay returns the name with no values (even if the name is not recommended). If GetCategoryFeatures indicates that Item Specifics are enabled for a leaf category, but GetCategorySpecifics doesn't return any recommendations for that category, the seller can still specify their own Item Specifics in that category.
Recommendations.CategoryID	string	Conditionally	The unique identifier of the leaf category for which the recommended Item Specifics and Product Identifier types apply to. This is always a category ID that you specified in the request. This field is always returned with each Recommendations container. Max length: 10.
Recommendations   .NameRecommendation	NameRecommendationType	Conditionally, repeatable: [0..*]	This container consists of Item Specific name/value pairs that are mandatory, recommended, or optional for the specified category. The value returned in the corresponding UsageConstraint field, just introduced in Version 1111, will indicate if the Item Specific is required, recommended, or optional when listing in that category. If no relevant Item Specific name/value pairs are found for the category, this container will not be returned.
Recommendations   .NameRecommendation.HelpText	string	Conditionally	The text in this field may provide some context on the content of the help page linked to in the HelpURL field. This field is only returned if the HelpURL field is returned, and is available.
Recommendations   .NameRecommendation.HelpURL	anyURI	Conditionally	This field contains a URL to a relevant eBay help page that may provide more information about a particular Item Specific. This field is only returned if a relevant eBay help page is available. If this field is returned, the HelpText field may also be returned and provide some context on the content of the help page.
Recommendations   .NameRecommendation.Name	string	Always	This string field is the name of the mandatory or recommended Item Specific or Product Identifier type (e.g. Brand/MPN). The seller should use the actual string in this field when creating, revising, or relisting an item with this Item Specific. The number of Item Specifics that are returned can be controlled with the MaxNames field in the call request. This field is always returned with each NameRecommendation container. See:     Using MaxNames filter     Setting Item Specifics in AddItem
Recommendations   .NameRecommendation   .RelevanceIndicator	RelevanceIndicatorType	Conditionally	This container is returned for an item specific if eBay has data on how many searches have been performed for listings in the category using that item specific. Note: This container is restricted to applications that have been granted permission to access this feature. You must submit an App Check ticket to request this access. In the App Check form, add a note to the Application Title/Summary and/or Application Details fields that you want access to 'Buyer Demand Data' in GetCategorySpecifics.
Recommendations   .NameRecommendation   .RelevanceIndicator   .SearchCount	long	Conditionally	The integer in this field indicates how many searches have been performed for listings in the category (in the last 30 days) using that item specific.
Recommendations   .NameRecommendation   .ValidationRules	RecommendationValidationRulesType	Always	This container provides details, instructions, and constraint information for each Item Specific name-value pairs. The fields that are returned under the ValidationRules container will vary per Item Specific. Three key fields to look for are MinValues, MaxValues, and VariationSpecifics. If the MinValues appears for an Item Specific (usually with a value of '1'), it indicates that the Item Specific is required for the category. For many Item Specifics, the MaxValues field is returned with a value of '1', but the value will be higher for Item Specifics that support more than one value. The VariationSpecifics field is only returned (with a value of 'Disabled') when a seller is not allowed to pass in that Item Specific at the variation level in a multiple-variation listing. This field is always returned with each NameRecommendation container.
Recommendations   .NameRecommendation   .ValidationRules.AspectUsage	AspectUsageCodeType	Conditionally	The value returned in this field will indicate if the item specific value is a product aspect (relevant to catalog products in the category) or an item/instance aspect, which is an aspect whose value will vary based on a particular instance of the product. Note: Currently, the AspectUsage field will only be returned for some item/instance aspects (and not product aspects). Examples of common instance aspects that are shared by many eBay categories include 'Custom Bundle', 'Bundle Description', 'Modified Item', 'Modification Description', and 'California Prop 65 Warning'. Many instance aspect values are allowed more characters than the standard 65 max character threshold, and sellers can look at the corresponding MaxValueLength field to get the maximum number of characters allowed for that particular instance aspect value. Applicable values: Instance (out) This enumeration value indicates that the Item Specific in the corresponding NameRecommendation.Name field is an 'instance aspect', which is an Item Specific whose value will vary based on a particular instance of the product. When creating a listing, the seller should pass in the name-value pair for this Item Specific through the Item.ItemSpecifics.NameValueList container of an AddItem call. Product (out) This enumeration value indicates that the Item Specific in the corresponding NameRecommendation.Name field is defined/derived from an eBay catalog product. 'Product' Item Specifics are also referred to as Product Aspects in Web flows and other APIs. Generally, catalog product-based Item Specifics should not be modified if the seller created/revise/relisted the item based on an eBay catalog product. (Not all values in AspectUsageCodeType apply to this field.) Code so that your app gracefully handles any future changes to this list.
Recommendations   .NameRecommendation   .ValidationRules.Confidence	int	Conditionally	Indicates eBay's confidence that this is the right name or value, given the data you specified your request. The confidence is based on historical items in the same category, with similar titles (if specified). This field is only returned when IncludeConfidence is included in the request and set to true. This field is not returned when SelectionMode is set to Prefilled. Min: 0. Max: 100.
Recommendations   .NameRecommendation   .ValidationRules   .MaxValueLength	int	Conditionally	This integer value will state the maximum length of the instance aspect's value. The seller must make sure not to exceed this value when setting instance aspects on a listing. This field is only returned for instance aspects (AspectUsage=Instance). The standard maximum length for an item specific value is 65 characters.
Recommendations   .NameRecommendation   .ValidationRules.MaxValues	int	Conditionally	Maximum number of values that you can specify for this Item Specific in listing requests (like AddItem) in the specified category. Most Item Specifics can only have one value. When this is greater than 1, your application can present the value recommendations (if any) as a multi-select list to the seller. (See SelectionMode to determine whether the seller needs to choose from eBay's recommendations or not.)
Recommendations   .NameRecommendation   .ValidationRules.MinValues	int	Conditionally	Minimum number of values that you can specify for this Item Specific in listing requests. Not returned if zero (0). If this field is returned, it indicates that the Item Specific is required in listing requests in the corresponding category. If the Relationship field is also present, it means this Item Specific is required when you specify its parent value in listing requests.
Recommendations   .NameRecommendation   .ValidationRules.Relationship	NameValueRelationshipType	Conditionally, repeatable: [0..*]	Indicates the Item Specific's logical dependency on another Item Specific, if any. For example, in a clothing category, Size Type could be recommended as a parent of Size, because Size=XL would mean something different to buyers when Size Type=Juniors or Size Type=Regular. Or in the US (in the future), a list of cities can vary depending on the state, so State could be recommended as a parent of City. Currently, categories only recommend a maximum of one parent for an Item Specific. For example, Size=XL could have a Size Type=Juniors parent in a Juniors clothing category. In the future, some categories may recommend multiple parents. For example, City=Mountain View could have parents like State=California, State=New York, and State=North Carolina. If an Item Specific has value dependencies (i.e., if it has value recommendations that contain Relationship), then all of its value recommendations are returned (regardless of the number you specified in MaxValuesPerName).
Recommendations   .NameRecommendation   .ValidationRules.Relationship   .ParentName	string	Conditionally	The name of another Item Specific that the current value depends on. For example, in a clothing category, "Size Type" could be recommended as a parent of Size.
Recommendations   .NameRecommendation   .ValidationRules.SelectionMode	SelectionModeCodeType	Conditionally	The enumeration value returned in this field indicates whether a seller can specify their own custom values for an Item Specific, or if they need to use a value (or values) that eBay has defined. Applicable values: FreeText (out) Indicates that the seller is allowed to specify their own value(s) for the corresponding Item Specific when creating, revising, or relisting an item and using that particular Item Specific. Prefilled (out) Indicates that the Item Specifics defined for an eBay catalog product will get pre-filled for a listing if the seller successfully matches their item to a product in eBay's catalog. To match an item to an eBay catalog product when adding or revising a listing, the seller provides either an Add/Revise/Relist eBay Product ID (ePID), or a Global Trade Identification Number such as a UPC, an EAN, anISBN), or a Brand/MPN pair. SelectionOnly (out) If this value is returned, it is recommended that the seller only use one of the recommended values for the corresponding Item Specific. In other words, the seller should use the exact string provided in one of the corresponding ValueRecommendation.Value fields when creating, revising, or relisting an item and using that particular Item Specific. (Not all values in SelectionModeCodeType apply to this field.) Code so that your app gracefully handles any future changes to this list.
Recommendations   .NameRecommendation   .ValidationRules   .UsageConstraint	UsageConstraintCodeType	Conditionally	This field is returned for each item specific that is returned in the response. The enumeration value returned will indicate whether the item specific is required, recommended, or optional. Note: Previously, returned item specifics were only 'marked' as required or optional. With the introduction of this new field, eBay is able to specify to sellers which item specifics are highly recommended, although not required. The item specifics that are recommended can possibly improve search results and/or sales conversion if the seller includes them in the listing. Applicable values: Optional (out) This enumeration value indicates that the corresponding item specific is completely optional for a listing in the category, but the seller should still include it if the item specific is relevant to the product and its value is known. Recommended (out) This enumeration value indicates that the corresponding item specific is typical and recommended for a listing in the category, but not fully required. The seller should include this item specific if its value is known because including it may improve search results and sale conversion. Required (out) This enumeration value indicates that the corresponding item specific is required for a listing in the category. The seller must include this item specific or the listing may be blocked. (Not all values in UsageConstraintCodeType apply to this field.) Code so that your app gracefully handles any future changes to this list.
Recommendations   .NameRecommendation   .ValidationRules.ValueFormat	ValueFormatCodeType	Conditionally	The format of the data type (e.g., date format) that eBay expects the item specific's value to adhere to in listing requests. A data type identified by the ValueType field may have different representations, and ValueFormat specifies the precise format that is required. Applicable values: CustomCode (out) Reserved for future or internal use. FullDate (out) This enumeration value indicates that a full date is used, including the month, day, and year in the following format: 'YYYYMMDD' PartialDate (out) This enumeration value indicates that a partial date is used, including the month and year in the following format: 'YYYYMM' Year (out) This enumeration value indicates that only the year is returned in the following format: 'YYYY' Code so that your app gracefully handles any future changes to this list.
Recommendations   .NameRecommendation   .ValidationRules.ValueType	ValueTypeCodeType	Conditionally	The data type (e.g., date) that eBay expects the value to adhere to in listing requests. Only returned if the data type is not Text. In some cases, more details about the data type are returned in the ValueFormat field. As buyers may search on the value you specify in AddItem, the ISBN, UPC, or EAN should match the value that was specified by the publisher or manufacturer. Note: The Numeric enumeration value is returned for whole integers (no decimal point), and the Decimal enumeration value is returned for numbers with decimals. Applicable values: See ValueType. Code so that your app gracefully handles any future changes to this list.
Recommendations   .NameRecommendation   .ValidationRules   .VariationPicture	VariationPictureRuleCodeType	Conditionally	Indicates whether the name (e.g., Color) can (or must) be used to classify the variation pictures. Applicable values: CustomCode (out) Reserved for future use. Disabled (out) This value indicates that the corresponding Item Specific name cannot be used in the Variations.Pictures.VariationSpecificName field if the seller is providing picture URLs through the Variations.Pictures.VariationSpecificPictureSet container in a 'FixedPriceItem' call when creating, revising, or relisting an item. The seller will have to find an Item Specific that is either 'Enabled' or 'Required' to use as a VariationSpecificName value. Enabled (out) This value indicates that the corresponding Item Specific name can be used in the Variations.Pictures.VariationSpecificName field if the seller is providing picture URLs through the Variations.Pictures.VariationSpecificPictureSet container in a 'FixedPriceItem' call when creating, revising, or relisting an item. Unlike the 'Required' value, 'Enabled' indicates that corresponding Item Specific name is just one option, and they may be other options to use as a VariationSpecificName value. Required (out) This value indicates that the corresponding Item Specific name must be used in the Variations.Pictures.VariationSpecificName field if the seller is providing picture URLs through the Variations.Pictures.VariationSpecificPictureSet container in a 'FixedPriceItem' call when creating, revising, or relisting an item. Code so that your app gracefully handles any future changes to this list.
Recommendations   .NameRecommendation   .ValidationRules   .VariationSpecifics	VariationSpecificsRuleCodeType	Conditionally	Indicates whether the recommended name/value pair can be used in an Item.Variations container in a fixed-price listing call. For example, a given category could disable a name like Brand in variation specifics (if Brand is only allowed in the item specifics at the Item level). The same category could enable a name like Size for variation specifics (in addition to recommending it for item specifics). If not returned, then the name/value can be used for both variation specifics and item specifics. Applicable values: CustomCode (out) Reserved for future use. Disabled (out) This value indicates that the corresponding Item Specific cannot be specified at the variation level. If an Item Specific cannot be used at the variation level, it usually indicates that the particular Item Specific should only be specified at the listing-level, as it is a product aspect that should be shared by all variations in the multiple-variation listing. Enabled (out) This value indicates that the corresponding Item Specific can be specified at the variation level. In the AddFixedPriceItem call, variation-specific name-value pairs are specified under the Variation.VariationSpecifics.NameValueList container. Code so that your app gracefully handles any future changes to this list.
Recommendations   .NameRecommendation   .ValueRecommendation	ValueRecommendationType	Conditionally, repeatable: [0..*]	Each ValueRecommendation container shows a common/recommended/popular value for the corresponding Item Specific. Values are not returned for every Item Specific, including some instance aspects (such as 'Bundle Description') where the text that is passed in for the Item Specific value may vary widely per seller, or if eBay does not have recommended values available for the Item Specific. The number of values that are returned for each Item Specific can be controlled with the MaxValuesPerName field in the call request. Note: For unique product identifying aspects, such as MPN, UPC, ISBN, or EAN, instead of an actual value being returned, boilerplate text is used, such as 'Does Not Apply'. If an MPN or GTIN is required, but the seller does not have the identifier, he/she can pass in the boilerplate text as an alternative to the actual identifier. In addition to the recommended value(s) for an Item Specific, a ValueRecommendation.ValidationRules container will be returned if the IncludeConfidence filter is included in the call request and set to true. The return 'Confidence' value is a percentage value that indicates how confident eBay is that the recommended value is a valid value for the corresponding Item Specific. The ValueRecommendation.ValidationRules container may also get returned for the 'Brand' Item Specific if the particular product brand in that listing category requires an association with an eBay catalog product. See:     Using MaxValuesPerName filter     Using IncludeConfidence filter     Setting Item Specific values in AddItem
Recommendations   .NameRecommendation   .ValueRecommendation   .ValidationRules	RecommendationValidationRulesType	Conditionally	Constraints that eBay places on this Item Specific value. Only returned when you configure your request to include relationships and/or confidence, and a recommended value is available. (Not returned when ExcludeRelationships is true and IncludeConfidence is false.)
Recommendations   .NameRecommendation   .ValueRecommendation   .ValidationRules.Confidence	int	Conditionally	Indicates eBay's confidence that this is the right name or value, given the data you specified your request. The confidence is based on historical items in the same category, with similar titles (if specified). This field is only returned when IncludeConfidence is included in the request and set to true. This field is not returned when SelectionMode is set to Prefilled. Min: 0. Max: 100.
Recommendations   .NameRecommendation   .ValueRecommendation   .ValidationRules   .ProductRequired	ProductRequiredCodeType	Conditionally	The enumeration value returned in this field will indicate whether or not the corresponding product brand requires listings within that category to be associated with an eBay catalog product. To create a listing that is associated with an eBay catalog product, the seller uses the ProductListingDetails container of the AddItem call. To find a matching product in the eBay catalog, the seller can use the new eBay Catalog API or FindProducts call of the eBay Shopping API. This field is only returned for the 'Brand' NameRecommendation container, and only if that particular product brand within that Product-Based Shopping Experience-enabled category requires a catalog product. Note: Due to the rollback of the Product-Based Shopping Experience mandate for all eBay categories (and brands within those categories), the ValidationRules.ProductRequired field will not get returned for any brands within any eBay category. Due to this fact, the ProductRequired field is currently not applicable. Applicable values: CustomCode (out) Reserved for internal or future use. Disabled (out) If this enumeration value is returned for a product brand within a category, the eBay seller is not expected to use an eBay catalog product when creating or revising their listing in this category for this product brand. Enabled (out) If this enumeration value is returned for a product brand within a category, the eBay seller should use an eBay catalog product when creating or revising their listing in this category for this product brand. Using an eBay catalog product for the specific category/brand to create/revise the listing is not a hard mandate, but it is necessary if the seller would like the listing to appear in product-based listing search results. Code so that your app gracefully handles any future changes to this list.
Recommendations   .NameRecommendation   .ValueRecommendation   .ValidationRules.Relationship	NameValueRelationshipType	Conditionally, repeatable: [0..*]	Indicates the Item Specific's logical dependency on another Item Specific, if any. For example, in a clothing category, Size Type could be recommended as a parent of Size, because Size=XL would mean something different to buyers when Size Type=Juniors or Size Type=Regular. Or in the US (in the future), a list of cities can vary depending on the state, so State could be recommended as a parent of City. Currently, categories only recommend a maximum of one parent for an Item Specific. For example, Size=XL could have a Size Type=Juniors parent in a Juniors clothing category. In the future, some categories may recommend multiple parents. For example, City=Mountain View could have parents like State=California, State=New York, and State=North Carolina. If an Item Specific has value dependencies (i.e., if it has value recommendations that contain Relationship), then all of its value recommendations are returned (regardless of the number you specified in MaxValuesPerName).
Recommendations   .NameRecommendation   .ValueRecommendation   .ValidationRules.Relationship   .ParentName	string	Conditionally	The name of another Item Specific that the current value depends on. For example, in a clothing category, "Size Type" could be recommended as a parent of Size.
Recommendations   .NameRecommendation   .ValueRecommendation   .ValidationRules.Relationship   .ParentValue	string	Conditionally	The value of another Item Specific that the current value depends on. For example, in a clothing category, if "Size Type" is the ParentName, then "Petite" could be recommended as a parent value for Size = Medium.
Recommendations   .NameRecommendation   .ValueRecommendation.Value	string	Conditionally	A recommended value for the corresponding, recommended Item Specific. Only returned when a recommended value is available.
Recommendations.Updated	boolean	Conditionally	This field is only returned if the user includes a timestamp in the LastUpdateTime field in the call request payload. If this field is returned as true, the Item Specific metadata for the specified category has changed since the date/time specified in the LastUpdateTime field. In this case, we suggest you retrieve the latest metadata for the category. If this field is returned as false, the Item Specific metadata for this category has not changed since the date/time specified in the LastUpdateTime field.
TaskReferenceID	string	Conditionally	A TaskReferenceID and a FileReferenceID value are returned if the CategorySpecificsFileInfo field is included in the call request and set to true. These values will be used as inputs in the downloadFile call of the File Transfer API. That API lets you retrieve a single (bulk) GetCategorySpecifics response with all the Item Specifics recommendations available for the requested site ID. (The downloadFile call downloads a .zip file as an attachment.) See downloadFile in the File Transfer API.

Standard Output Fields

Ack	AckCodeType	Always	A token representing the application-level acknowledgement code that indicates the response status (e.g., success). The AckCodeType list specifies the possible values for the Ack field. Applicable values: CustomCode (out) Reserved for internal or future use. Failure (out) This value indicates that the call request processing failed. Success (out) This value indicates that the call request was processed successfully without any issues. Warning (out) This value indicates that the call request was successful, but processing was not without any issues. These issues can be checked in the Errors container, that will also be returned when one or more known issues occur with the call request. (Not all values in AckCodeType apply to this field.) Code so that your app gracefully handles any future changes to this list.
Build	string	Always	This refers to the specific software build that eBay used when processing the request and generating the response. This includes the version number plus additional information. eBay Developer Support may request the build information when helping you resolve technical issues.
CorrelationID	string	Conditionally	Most Trading API calls support a MessageID element in the request and a CorrelationID element in the response. If you pass in a MessageID in a request, the same value will be returned in the CorrelationID field in the response. Pairing these values can help you track and confirm that a response is returned for every request and to match specific responses to specific requests. If you do not pass a MessageID value in the request, CorrelationID is not returned. Note: GetCategories is designed to retrieve very large sets of metadata that change once a day or less often. To improve performance, these calls return cached responses when you request all available data (with no filters). When this occurs, the MessageID and CorrelationID fields aren't applicable. However, if you specify an input filter to reduce the amount of data returned, the calls retrieve the latest data (not cached). When this occurs, MessageID and CorrelationID are applicable.
Errors	ErrorType	Conditionally, repeatable: [0..*]	A list of application-level errors (if any) that occurred when eBay processed the request.
Errors.ErrorClassification	ErrorClassificationCodeType	Conditionally	API errors are divided between two classes: system errors and request errors. Applicable values: CustomCode (out) Reserved for internal or future use. RequestError (out) An error has occurred either as a result of a problem in the sending application or because the application's end-user has attempted to submit invalid data (or missing data). In these cases, do not retry the request. The problem must be corrected before the request can be made again. If the problem is due to something in the application (such as a missing required field), the application must be changed. If the problem is a result of end-user data, the application must alert the end-user to the problem and provide the means for the end-user to correct the data. Once the problem in the application or data is resolved, resend the request to eBay with the corrected data. SystemError (out) Indicates that an error has occurred on the eBay system side, such as a database or server down. An application can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form. Code so that your app gracefully handles any future changes to this list.
Errors.ErrorCode	token	Conditionally	A unique code that identifies the particular error condition that occurred. Your application can use error codes as identifiers in your customized error-handling algorithms. See the "Errors by Number" document.
Errors.ErrorParameters	ErrorParameterType	Conditionally, repeatable: [0..*]	This optional element carries a list of context-specific error variables that indicate details about the error condition. These are useful when multiple instances of ErrorType are returned.
Errors.ErrorParameters   [ attribute ParamID ]	string	Conditionally	This optional element carries a list of context-specific error variables that indicate details about the error condition. These are useful when multiple instances of ErrorType are returned.
Errors.ErrorParameters.Value	string	Conditionally	This is the value of the request parameter noted in the ParamID attribute. So, if the ParamID value was ItemID, the value in this field would be the actual value of that ItemID.
Errors.LongMessage	string	Conditionally	A more detailed description of the condition that raised the error.
Errors.SeverityCode	SeverityCodeType	Conditionally	Indicates whether the error is a severe error (causing the request to fail) or an informational error (a warning) that should be communicated to the user. Applicable values: CustomCode (out) Reserved for internal or future use. Error (out) The request that triggered the error was not processed successfully. When a serious application-level error occurs, the error is returned instead of the business data. If the source of the problem is within the application (such as a missing required element), change the application before you retry the request. If the problem is due to end-user input data, please alert the end-user to the problem and provide the means for them to correct the data. Once the problem in the application or data is resolved, you can attempt to re-send the request to eBay. If the source of the problem is on eBay's side, An application can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form. See the Compatible Application Check section of the eBay Features Guide for more information. Warning (out) The request was processed successfully, but something occurred that may affect your application or the user. For example, eBay may have changed a value the user sent in. In this case, eBay returns a normal, successful response and also returns the warning. When a warning occurs, the error is returned in addition to the business data. In this case, you do not need to retry the request (as the original request was successful). However, depending on the cause or nature of the warning, you might need to contact either the end user or eBay to effect a long term solution to the problem to prevent it from reoccurring in the future. Code so that your app gracefully handles any future changes to this list.
Errors.ShortMessage	string	Conditionally	A brief description of the condition that raised the error.
HardExpirationWarning	string	Conditionally	Expiration date of the user's authentication token. Only returned within the 7-day period prior to a token's expiration. To ensure that user authentication tokens are secure and to help avoid a user's token being compromised, tokens have a limited life span. A token is only valid for a period of time (set by eBay). After this amount of time has passed, the token expires and must be replaced with a new token.
Timestamp	dateTime	Always	This value represents the date and time when eBay processed the request. The time zone of this value is GMT and the format is the ISO 8601 date and time format (YYYY-MM-DDTHH:MM:SS.SSSZ). See the Time Values section in the eBay Features Guide for information about this time format and converting to and from the GMT time zone. Note: GetCategories and other Trading API calls are designed to retrieve very large sets of metadata that change once a day or less often. To improve performance, these calls return cached responses when you request all available data (with no filters). When this occurs, this time value reflects the time the cached response was created. Thus, this value is not necessarily when the request was processed. However, if you specify an input filter to reduce the amount of data returned, the calls retrieve the latest data (not cached). When this occurs, this time value does reflect when the request was processed.
Version	string	Always	The version of the response payload schema. Indicates the version of the schema that eBay used to process the request. See the Standard Data for All Calls section in the eBay Features Guide for information on using the response version when troubleshooting CustomCode values that appear in the response.

Input Output Detail Controls Samples Change History

Detail Controls

DetailLevel

This call does not support varying Detail Levels. You do not need to pass DetailLevel in the request.

Input Output Detail Controls Samples Change History

Samples

New to making API calls? Please see Making a Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Available samples:

• Basic Call ↓ - Retrieves recommended Item Specifics for a single category.
• Item Specifics for a Fashion Category that Supports Variations ↓ - Retrieves recommendations for the Women's Tops & Blouses category on the eBay US site.

Retrieves recommended Item Specifics for a single category.

Description

This sample retrieves recommended Item Specifics for a category on the eBay US site. If recommendations are available for the category, each NameRecommendation node returns the recommended name, validation rules, and recommended values (if any). (Categories that support custom Item Specifics do not necessarily have recommendations. So, this call does not always return data.)

Input

The key input for this sample is CategorySpecific.CategoryID. For the recommendations to be useful in listing calls, the category ID must be a category that is flagged as ItemSpecificsEnabled according to GetCategoryFeatures. The request version (in the HTTP header) is 609 (not shown).

Please note that this sample was created based on a test category (Test Blenders), so this category does not return any recommendations in the Sandbox or in Production. A new sample will be created based on production data in a future release.

XML format.

<?xml version="1.0" encoding="utf-8"?>
<GetCategorySpecificsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <WarningLevel>High</WarningLevel>
  <CategorySpecific>
    <CategoryID>9355</CategoryID>
  </CategorySpecific>
  <RequesterCredentials>
    <eBayAuthToken>Y***********E</eBayAuthToken>
  </RequesterCredentials>
</GetCategorySpecificsRequest>

Output

In the output, each NameRecommendation node returns the recommended names and validation rules for two Item Specifics (Color and Brand). One of the recommendations also returns two ValueRecommendation nodes with recommended values (KitchenAid and The Magic Bullet).

The validation rules indicate that the Item Specifics are optional in listing calls (MinValues is not returned), only one value is allowed per Item Specific (MaxValues is 1), and you can use one of the recommended values or specify a custom value (SelectionMode is FreeText).

If you try a category and you get no results, it could be because there are no recommendations in that category. Also make sure you are using request version 609 or higher, and make sure the category supports custom Item Specifics.

XML format.
<?xml version="1.0" encoding="UTF-8"?>
<GetCategorySpecificsResponse
  xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2019-11-04T18:49:54.845Z</Timestamp>
  <Ack>Success</Ack>
  <Version>1131</Version>
  <Build>E1131_CORE_API6_19105226_R1</Build>
  <Recommendations>
    <CategoryID>9355</CategoryID>
    <NameRecommendation>
      <Name>Brand</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MinValues>1</MinValues>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Unbranded</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Apple</Value>
        <ValidationRules>
          <ProductRequired>Enabled</ProductRequired>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Samsung</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>LG</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Google</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Motorola</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>BlackBerry</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>OnePlus</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>HTC</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Kyocera</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Huawei</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>ZTE</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Essential</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Sony</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Nokia</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Casio</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>ASUS</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Razer</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>CAT</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>BLU</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Xiaomi</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Amazon</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>LeTV</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Pantech</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Microsoft</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Model</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MinValues>1</MinValues>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Acer Liquid E700</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Acer Liquid Z6</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel 991</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel A3</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel A5 LED</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Fierce XL</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Fire 2 3.5</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Fire C 2G</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Fire C 3G</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Fire E</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Go Play</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Idol 4</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Idol 4S</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Mpop</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel OneTouch Fierce 2</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel OneTouch Idol 3</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel OT-355</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel OT-602</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Pixi 3 3.5</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Pixi 3 4</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Pixi 3 4.5</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Pixi 4</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Pixi 4 Plus Power</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Pixi First</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alcatel Pop 3 5</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>MPN</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MinValues>1</MinValues>
        <MaxValues>30</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Does Not Apply</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Color</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MinValues>1</MinValues>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Beige</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Black</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Blue</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Brown</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Clear</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Gold</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Green</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Gray</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Orange</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Pink</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Purple</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Red</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Silver</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>White</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Yellow</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Multicolor</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Storage Capacity</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MinValues>1</MinValues>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>512 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>256 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>128 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>64 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>32 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>16 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>13.52 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>13.31 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>13.21 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>11.26 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>10 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>8 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>5.12 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>5.5 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>4 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3.61 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.97 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.56 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.25 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1.8 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1.64 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1.24 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1.13 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Network</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>1&1</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1pMobile</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>360Coms Telecom</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1 Telekom</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>AAPT</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Access Wireless</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>ACN</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>ADAC</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Adamo</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Affinity Cellular</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>AF Mobile</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>AfriMobile</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Airtel</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>AirVoice Wireless</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Airwave Smart Mobile</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Akiwifi</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>ALDImobile</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Aldi Talk</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alfa</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alltel</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>AlwaysOnline Wireless</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>amaysim</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Amena</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Amp'd Mobile</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Anywhere Sim</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Manufacturer Color</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MinValues>1</MinValues>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Custom Bundle</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>SelectionOnly</SelectionMode>
        <AspectUsage>Instance</AspectUsage>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation>
        <Value>No</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Yes</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Style</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Bar</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Flip</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Slider</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Swivel</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Bundle Description</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <AspectUsage>Instance</AspectUsage>
        <MaxValueLength>200</MaxValueLength>
        <Relationship>
          <ParentName>Custom Bundle</ParentName>
        </Relationship>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Contract</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Without Contract</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>With Contract</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Prepaid</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Features</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>30</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>3G Data Capable</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>4G Data Capable</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>4K Video Recording</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Accelerometer</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Ambient Light Sensor</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>ANT+</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Apple Care</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Barometer</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Bluetooth Enabled</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Camera</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Color Screen</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Double Lens Camera</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Dual Rear Cameras</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Dual SIM</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>EDGE</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>E-mail Access</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>eSIM</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Facial Recognition</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Fingerprint Sensor</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>FM Radio</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Front Camera</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Geotagging</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Global Ready</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>GPS</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Gyro Sensor</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Camera Resolution</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>0.08MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>0.1MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>0.3MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>0.5MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>0.6MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1.0MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1.2MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1.3MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1.9MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.0MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.1MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.3MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3.0MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3.1MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3.2MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3.5MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>4.0MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>5.0MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>5.1MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>6.7MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>8.0MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>8.1MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>8.7MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>10.0MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>11.0MP</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Modified Item</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>SelectionOnly</SelectionMode>
        <AspectUsage>Instance</AspectUsage>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation>
        <Value>No</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Yes</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Operating System</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Aliyun OS</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Android</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Asha Platform</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>BADA</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>BlackBerry 10</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>BlackBerry 3-7</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>BlackBerry OS</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Brew</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Danger OS</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Firefox OS</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Fire OS</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>GridOS</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>HP/Palm WebOS</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>iOS</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Linux</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Maemo</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Nokia X</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>PrivatOS</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>RIM</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>S40</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Sailfish OS</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Symbian</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>WebOS</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Windows Mobile</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Windows Phone 10</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Modification Description</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <AspectUsage>Instance</AspectUsage>
        <MaxValueLength>200</MaxValueLength>
        <Relationship>
          <ParentName>Modified Item</ParentName>
        </Relationship>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Cellular Band</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Non-Domestic Product</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>SelectionOnly</SelectionMode>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation>
        <Value>No</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Yes</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Applicable Regions</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <MaxValueLength>200</MaxValueLength>
        <Relationship>
          <ParentName>Non-Domestic Product</ParentName>
        </Relationship>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Screen Size</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>1 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1.4 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1.5 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1.7 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1.8 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1.9 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.1 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.2 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.3 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.4 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.5 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.6 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.7 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.8 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2.9 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3.1 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3.2 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3.3 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3.4 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3.5 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3.6 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3.7 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3.8 in</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Lock Status</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Network Locked</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Network Unlocked</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Factory Unlocked</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Memory Card Type</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Not Applicable</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>CompactFlash</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>eMMC</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Memory PRO Duo</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Memory Stick Duo</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Memory Stick Micro (M2)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Memory Stick PRO</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Memory Stick PRO Duo</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Memory Stick PRO-HG Duo</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>MicroSD</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>MicroSDHC</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>MicroSDXC</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>miniSD</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>MiniSDHC</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>MultiMediaCard (MMC)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>MultiMediaCard Plus (MMC+)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>RS-MMC</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>SDHC Card</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>SD Memory Card</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>SDXC Card</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Smartmedia Card</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Solo Mobile</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>TransFlash Card</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>xD-Picture Card</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Model Number</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>A1203 (GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1241 (GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1303 (GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1324 (China)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1325 (China)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1332 (GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1349 (CDMA)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1387 (CDMA + GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1428 (GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1429 (CDMA + GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1429 (GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1431 (China)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1442 (China)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1453 (CDMA + GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1456 (CDMA + GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1457 (GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1507 (GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1516 (China)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1518 (China)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1522 (CDMA + GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1522 (GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1524 (CDMA + GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1526 (China)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1528 (China)</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>A1529 (GSM)</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Processor</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Single Core</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Dual Core</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Quad Core</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Hexa Core</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Quad+Quad Core</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Octa Core</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Deca Core</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>RAM</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>1 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>4 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>5 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>6 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>7 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>8 GB</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
  </Recommendations>
</GetCategorySpecificsResponse>

Back to list of samples

Retrieves recommendations for the Women's Tops & Blouses category on the eBay US site.

Description

This sample retrieves recommended item specifics for the "Women's Clothing : Tops & Blouses" category on the eBay US site. This category supports multi-variation listings.

Input

The key input for this sample is CategorySpecific.CategoryID. We know which categories support variations by checking VariationsEnabled in GetCategoryFeatures.

XML format.

<?xml version="1.0" encoding="utf-8"?>
<GetCategorySpecificsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <CategorySpecific>
    <CategoryID>53159</CategoryID>
  </CategorySpecific>
  <RequesterCredentials>
    <eBayAuthToken>Y***********E</eBayAuthToken>
  </RequesterCredentials>
</GetCategorySpecificsRequest>

Output

For this sample, we'll focus on the validation rules in the response.

The names Style, Size Type, Size (Women's), Brand, and Color have MinValues set to 1. This means these item specifics are required in listings. (Color will no longer be required in the near future.)

Style, Size Type, and Color have SelectionMode set to SelectionOnly. This means that if you use these item specifics, you need to choose one of the values that eBay has defined; you cannot specify other values.

Style, Brand, and Occasion have VariationSpecifics set to Disabled. This means you cannot use Style, Brand, or Occasion in variations (because they should be the same for all items in the listing). Therefore, you can only use Style, Brand, and Occasion in the listing's overall item specifics.

Women's sizes are typically grouped into size types, such as Petites or Plus. eBay reflects this kind of grouping as a parent/child relationship. So, Size (Women's) has ParentName set to Size Type, and different ParentValue choices (e.g., Petites vs. Plus) for different sizes. If all variations in a listing use the same Size Type but have different sizes, you can put Size Type (e.g., Petites) in the item specifics, and Size (Women's) in each variation within the listing.

Similarly, Shade has ParentName set to Color, and different ParentValue choices (e.g., Blues vs. Pinks) for different shades.

XML format.
<?xml version="1.0" encoding="UTF-8"?>
<GetCategorySpecificsResponse
  xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2019-11-04T19:40:18.189Z</Timestamp>
  <Ack>Success</Ack>
  <Version>1131</Version>
  <Build>E1131_CORE_API6_19105226_R1</Build>
  <Recommendations>
    <CategoryID>53159</CategoryID>
    <NameRecommendation>
      <Name>Brand</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MinValues>1</MinValues>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Unbranded</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Handmade</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Abercrombie & Fitch</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Aéropostale</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Ann Taylor</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Banana Republic</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>bebe</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Chico's</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Coldwater Creek</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Eileen Fisher</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Express</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Free People</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Hollister</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>J.CREW</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Jones New York</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Lane Bryant</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Liz Claiborne</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Old Navy</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Ralph Lauren</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Splendid</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Talbots</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Tommy Hilfiger</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>& Other Stories</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>0039 Italy</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>1. STATE</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Size Type</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MinValues>1</MinValues>
        <MaxValues>1</MaxValues>
        <SelectionMode>SelectionOnly</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Regular</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Petites</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Plus</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Juniors</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>MPN</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Does Not Apply</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Size (Women's)</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MinValues>1</MinValues>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <Relationship>
          <ParentName>Size Type</ParentName>
        </Relationship>
      </ValidationRules>
      <ValueRecommendation>
        <Value>2XS</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Juniors</ParentValue>
          </Relationship>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>XS</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Juniors</ParentValue>
          </Relationship>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>S</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Juniors</ParentValue>
          </Relationship>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>M</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Juniors</ParentValue>
          </Relationship>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>L</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Juniors</ParentValue>
          </Relationship>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>XL</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2XL</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>3XL</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>4XL</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>5XL</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Plus</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>6XL</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Plus</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>7XL</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Plus</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>8XL</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Plus</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>9XL</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Plus</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>10XL</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Plus</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>00</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Juniors</ParentValue>
          </Relationship>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>0</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>2</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>4</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>6</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>8</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>10</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>12</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>14</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>16</Value>
        <ValidationRules>
          <Relationship>
            <ParentName>Size Type</ParentName>
            <ParentValue>Regular</ParentValue>
          </Relationship>
        </ValidationRules>
      </ValueRecommendation>
      <HelpURL>http://pages.ebay.com/sell/sizechart.html</HelpURL>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Style</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MinValues>1</MinValues>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Blouse</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Bodysuit</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Tank Top</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>T-Shirt</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Material</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Acetate</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Acrylic</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Acrylic Blend</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Angora</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Bamboo</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Cashmere</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Cashmere Blend</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Chiffon</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Corduroy</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Cotton</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Cotton Blend</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Denim</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Down</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Elastane</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Faux Fur</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Faux Leather</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Faux Satin</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Faux Silk</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Faux Suede</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Fishnet</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Flannel</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Fleece</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>French Terry</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Fur</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Hemp</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Color</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Beige</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Black</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Blue</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Brown</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Gold</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Gray</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Green</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Ivory</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Multicolor</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Orange</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Pink</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Purple</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Red</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Silver</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>White</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Yellow</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Occasion</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Career</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Casual</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Formal</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Party</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Pattern</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Animal Print</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Camouflage</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Chevron</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Damask</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Diamond</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Fair Isle</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Floral</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Geometric</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Gingham</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Herringbone</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Houndstooth</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Ikat</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Ombré</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Paisley</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Pinstripe</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Plaid</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Polka Dot</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Solid</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Striped</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Tartan</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Tie Dye</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Theme</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Beach</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Boho</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Charity</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Festival</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Funny</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Gothic</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Grunge</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Hip Hop</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Hipster</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Love</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Nerdy</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Punk</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Retro</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Rock</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Rockabilly</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Scary</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Sexy</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Sports</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Steampunk</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Victorian</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Western</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Sleeve Style</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Bell Sleeve</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Button Cuff</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Cap Sleeve</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Cold Shoulder Sleeve</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Dolman Sleeve</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Kimono Sleeve</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Puff Sleeve</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Raglan Sleeve</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Roll Tab Sleeve</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Slit Sleeve</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Spaghetti Strap</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Modified Item</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>SelectionOnly</SelectionMode>
        <AspectUsage>Instance</AspectUsage>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation>
        <Value>No</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Yes</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Neckline</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Asymmetrical Neck</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Boat Neck</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Cowl Neck</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Crew Neck</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Halter</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Keyhole Neck</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Mandarin Collar</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Mock Neck</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Off-the-Shoulder</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>One Shoulder</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Scoop Neck</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Square Neck</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Strapless</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Sweetheart</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Turtleneck</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>V-Neck</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Modification Description</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
        <AspectUsage>Instance</AspectUsage>
        <MaxValueLength>200</MaxValueLength>
        <Relationship>
          <ParentName>Modified Item</ParentName>
        </Relationship>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Product Line</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Biya by Johnny Was</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Cabi Fall 2016 Collection</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Chico's Zenergy</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>D&T Shirtified Gildan</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>LuLaRoe Americana</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>LuLaRoe Irma</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>LuLaRoe Joy</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>LuLaRoe Perfect Tee</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>LuLaRoe Randy</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Marc New York Performance</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>rag & bone/JEAN</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Features</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>30</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Backless</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Belt</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Built-In Bra</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Buttons</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Collared</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Collarless</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Corset</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Crochet</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Drawstring</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Fitted</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>French Cuff</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Hooded</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Lace Up</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>No Iron</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Oversized</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Plunging Neckline</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Pockets</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Pullover</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Shelf Bra</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Stretch</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Thermal</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Tie-Front</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Zipper</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Length</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Cropped</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Hips</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Tunic</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Waist</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Sleeve Length</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>3/4 Sleeve</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Long Sleeve</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Short Sleeve</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Sleeveless</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Accents</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>30</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Appliqué</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Beaded</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Bows</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Chain</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Color Block</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Crease-free</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Crinkle</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Crochet</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Cut Out</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Draped</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Drop Waist</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Embroidered</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Empire Waist</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Eyelets</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Feathers</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Fringe</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Glitter</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Graphics</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Layered Look</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Metallic</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Neon</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Pleated</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Rhinestones</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Ripped</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Ruched</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Featured Graphics</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>50s</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>5 Seconds of Summer</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>90s</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>ACDC</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Admiral Ackbar</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Adventure Time</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Aerosmith</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alice Cooper</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alice in Chains</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alice in Wonderland</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alien</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>All Time Low</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Alphabet</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>American Flag</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>American Horror Story</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Anakin Skywalker</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Angel Wings</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Anime</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Anime Girl</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Arctic Monkeys</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Ariana Grande</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Army</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Asking Alexandria</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Avenged Sevenfold</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Avril Lavigne</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Sub-Style</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Babydoll Top</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Baseball Shirt</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Basic Tee</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Button-Down Shirt</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Cami</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Graphic Tee</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Henley</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Kimono</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Peasant Top</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Peplum Top</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Polo Shirt</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Tube Top</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Wrap Top</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Garment Care</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Dry-clean Only</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Easy Iron</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Hand-wash only</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Machine Washable</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Non Iron</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Country/Region of Manufacture</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>SelectionOnly</SelectionMode>
        <VariationSpecifics>Disabled</VariationSpecifics>
      </ValidationRules>
      <ValueRecommendation>
        <Value>Unknown</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Afghanistan</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Albania</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Algeria</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>American Samoa</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Andorra</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Angola</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Anguilla</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Antigua and Barbuda</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Argentina</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Armenia</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Aruba</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Australia</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Austria</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Azerbaijan</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Bahamas</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Bahrain</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Bangladesh</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Barbados</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Belarus</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Belgium</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Belize</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Benin</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Bermuda</Value>
        <ValidationRules/>
      </ValueRecommendation>
      <ValueRecommendation>
        <Value>Bhutan</Value>
        <ValidationRules/>
      </ValueRecommendation>
    </NameRecommendation>
    <NameRecommendation>
      <Name>Exact Material</Name>
      <ValidationRules>
        <ValueType>Text</ValueType>
        <MaxValues>1</MaxValues>
        <SelectionMode>FreeText</SelectionMode>
      </ValidationRules>
    </NameRecommendation>
  </Recommendations>
</GetCategorySpecificsResponse>

Back to list of samples

Input Output Detail Controls Samples Change History

Change History

Change Date	Description
1161 2020-07-06	NameRecommendation.RelevanceIndicator (added): This container is returned for item specifics if eBay has data on how many searches have been performed for listings in corresponding category using that item specific. This feature requires special access from eBay Developers Program. RelevanceIndicatorType (added): This type supports the Buyer Demand Data feature and is used by the RelevanceIndicator container. This feature requires special access from eBay Developers Program.
1129 2019-10-11	MaxNames, MaxValuesPerName (modified): The behavior of these request filters and the logic of the GetCategorySpecifics call has changed. There is no longer an upper constraint on the number of item specific names and values that can be returned in the response, and the default behavior is for GetCategorySpecifics to return all available item specific names and values if these request filters are not used.
1111 2019-06-07	UsageConstraintCodeType (added): This enumerated type is used by the NameRecommendation.ValidationRules.UsageConstraint field to indicate whether the item specific is required, recommended, or optional. ValidationRules.UsageConstraint (added): This field is returned for each item specific that is returned in the response. The enumeration value returned will indicate whether the item specific is required, recommended, or optional.
1101 2019-03-29	ProductRequiredCodeType (doc change): Due to the rollback of the Product-Based Shopping Experience mandate for all eBay categories (and brands within those categories), this type is no longer applicable since the ValidationRules.ProductRequired field will not get returned for any brands within any eBay category. ValidationRules.ProductRequired (modified): Due to the rollback of the Product-Based Shopping Experience mandate for all eBay categories (and brands within those categories), the ValidationRules.ProductRequired field will not get returned for any brands within any eBay category.
1077 2018-08-31	NameRecommendation.Name (modified): New 'California Prop 65 Warning' instance aspect added to support a new California Proposition 65 Warning message that can be added to a listing. This new instance aspect is returned if the category supports the new 'California Prop 65 Warning' item specific. The maximum limit for the message is 800 characters, and this threshold value is returned in the corresponding ValidationRules.MaxValueLength field.
1057 2018-04-13	AspectUsageCodeType (added): New type used by the AspectUsage field that is returned to indicate if a category aspect is a product-level aspect, or if it is an aspect that is typically unique to a particular instance of a product in that category. ValidationRules.AspectUsage (added): New field returned to indicate if the item specific value is a product aspect (relevant to catalog products in the category) or an item/instance aspect, which is an aspect whose value will vary based on a particular instance of the product. ValidationRules.MaxValueLength (added): New field that states the maximum length of the aspect's value. The seller must make sure not to exceed this value when setting instance aspects on a listing.
1047 2018-02-02	ProductRequiredCodeType (added): This enumerated type contains the values that indicate whether or not a product brand within an eBay category requires an eBay seller to create a listing using an eBay catalog product. ValidationRules.ProductRequired (added): New field used to indicate if the corresponding product brand requires that an eBay seller create a listing using an eBay catalog product. This field is only returned for the 'Brand' NameRecommendation container, and is only returned if the particular eBay category is a Product-Based Commerce enforced category.
1039 2017-10-17	GetCategorySpecificsRequest.MaxNames (modified): The maximum returned Item Specifics threshold value has been increased to 25.
0989 2017-01-20	Recommendations.ProductIdentifiers (added): (for future use only) This new container shows the product identifier types (such as ISBN, UPC, etc.) that are supported/required for the eBay category. If the MinRequired value for a product identifier type is '1', that product identifier type must be used at listing time. Product identifiers will be passed in as name/value pairs in the ProductListingDetails container (or VariationProductListingDetails container for multiple-variation listings) in an AddItem/AddFixedPriceItem call.
0945 2015-10-15	ValueTypeCodeType (modified): New Numeric enumeration value added. This new value will replace the Decimal enumeration value for whole integers (no decimal point) going forward from version 945. For the version 943 WSDL and older, the Decimal value will still be returned in for integers and numbers with decimals.
0931 2015-07-10	NameValueList.Name (modified): The maximum length was increased to 65. NameValueList.Value (modified): The maximum length was increased to 65.
0841 2013-09-19	CategoryID, CategorySpecific.CategoryID (modified): GetCategorySpecifics enhanced to retrieve Item Specifics for any category, and not just leaf categories.
0741 2011-09-28	CategoryID, IncludeConfidence, CategorySpecificsFileInfo (doc change): Clarified that IncludeConfidence requires CategoryID to also be specified. This means it typically cannot be used with CategorySpecificsFileInfo (when data for all categories is retrieved)
0729 2011-07-06	ValueFormat (added): Provides details about the format of a value type, such as a date format. ValueType (modified): Date added as a data type.
0661 2010-03-17	NameRecommendation (modified): When GetCategoryFeatures shows ConditionEnabled=Enabled or Required for the listing's primary category, item condition is suppressed from custom Item Specifics recommendations with request version 661 and higher in the sandbox and with request version 667 and higher in production.
0653 2010-01-20	CategoryID (modified): The first 100 categories in the request are processed. Additional categories are ignored. (Previously, 200-275 categories were processed.)
0615 2008-04-29	VariationPictures, VariationSpecifics (added): VariationSpecifics indicates whether the recommendations can be used in variations. VariationPictures indicates whether a recommended name should be used to classify variation pictures.
0611 2009-04-01	CategorySpecificsFileInfo, FileReferenceID, TaskReferenceID (added): New IDs can be used with the File Transfer API to download recommendations for all categories in a single call.
0609 2009-03-18	CategoryItemSpecifics (deprecated): CategoryItemSpecifics is not returned with request version 609 and higher. Use Recommendations instead. CategorySpecific, ExcludeRelationships, IncludeConfidence, Recommendations (added): Three new input nodes and fields. Recommendations is returned with request version 609 and higher.
0523 2007-07-25	(added) New call.

Copyright © 2005–2023 eBay Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.