# CategorySuggestFromText

Returns categories that are similar to text that you specify.

By default, this action operates by sending a `Query` action to the Agentstore, but it can send a `SuggestOnText` action instead, by using the UseSuggestOnText parameter. `SuggestOnText` and `Query` work slightly differently. `SuggestOnText` is faster, but `Query` is more accurate. Reducing the MaxQueryTerms when UseSuggestOnText is set to `False` (the default) speeds up the `CategorySuggestFromText` action, but reduces accuracy.

## Example

    http://12.3.4.56:9020/action=CategorySuggestFromText&QueryText=Caring for passiflora incarnata

This action requests categories that are conceptually similar to the text Caring for passiflora incarnata.

    http://12.3.4.56:9020/action=CategorySuggestFromText&TaxonomyName=RecipesTaxonomy&QueryText=summer dinner party

This action requests categories within `RecipesTaxonomy` that are conceptually similar to summer dinner party.

## Required Parameters

The following action parameters are required.

Parameter | Description
--- | ---
QueryText | The text that you want to use to suggest categories.

## Optional Parameters

This action accepts the following optional parameters.

Parameter | Description
--- | ---
AgentBoolean | Whether to use Boolean restrictions for a category.
AnyLanguage | Whether to retrieve categories that were stored in all languages.
Databases | Restricts results to a specific category database.
DocRef | The references of the documents to suggest on.
FieldText | A field restriction to apply to results.
FullPathOnly | Whether to return only the full path from the schema root to the category. This parameter applies only when you set ShowCategoryPath to `True`.
IgnoreSpecials | Whether to ignore special characters in the query.
IncludeTopLevel | Whether to include the top level category in a path that shows the position of the category. This parameter applies only when you set ShowCategoryPath to `True`.
MaxQueryTerms | The maximum number of terms to use in the query.
NumResults | The number of results to return.
Params | `Query` action parameters to add.
PrintFields | Whether to display category fields.
Schema | The ID of the category to set as the root for the hierarchy, to restrict the results to this category and its descendants.
ShowCategoryPath | Whether to show each returned category in its place in the category hierarchy.
SpellCheck | Whether to use corrected spellings to suggest categories.
TaxonomyName | Restricts the results to a category within the specified taxonomy.
TextParse | Whether to treat the document as XML or IDX.
Threshold | The relevance threshold of the result categories.
UserName | The name of the user that sends the action.
UseSuggestOnText | Whether to send a `SuggestOnText` action to Agentstore instead of a `Query` action.
Values | Values for the specified Params.

This action accepts the following standard ACI action parameters.

Parameter | Description
--- | ---
ActionID | A string to use to identify an ACI action.
EncryptResponse | Encrypt the output.
FileName | The file to write output to.
ForceTemplateRefresh | Forces the server to load the template from disk.
Output | Writes output to a file.
ResponseFormat | The format of the action output.
Template | The template to use for the action output.
TemplateParamCSVs | A list of variables to use for the specified template.

_FT_HTML5_bannerTitle.htm