Constructor's One Way Synonym API allows a user to define a word or words (parent phrase) which will be treated as synonymous to several other word or words (child phrases) by Constructor.io's search algorithms in only one direction.
In other words, search results for the parent phrase will be enriched with all results matching any of the child phrase(s) associated with that parent phrase, but results for the child phrase(s) will be unchanged. Linguistics typically refers to these as hyperonyms and hyponyms.
As an example, a customer of a grocery store may search for
fruit (parent phrase) and expect to see all items that match
apples, etc (child phrases) along with items matching just
The following documentation covers adding one-way synonyms manually via the API, but these can also be added in the dashboard.
Constructor.io algorithms can identify many synonyms using data science for specific eCommerce verticals such as fashion, grocery and others. Reach out to Constructor.io support to learn more and to enable this feature.
One way synonyms are set on each index key separately, so a customer can have separate synonym rules for two independent properties, such as their Dutch and French grocery stores.
Synonyms ignore case, so a synonym rule for
milk chocolate would apply to
delicious milk chocolate as well as
DELICIOUS MILK CHOCOLATE .
Exact Phrase Match
Synonyms match an exact phrase, so a child phrase for
chocolate milk would match products like
McCormick's 2% Chocolate Milk, but would not apply to
milk chocolate or
chocolate-flavored reduced-fat milk. To match these products, you'd need to include child phrases rules for
milk chocolate and
chocolate-flavored reduced-fat milk.
This approach is taken because intervening words and term order can influence meaning: as one example, a
shirt dress is not equivalent to a
dress shirt. Another case (mentioned in the example above) is that
milk chocolate is not equivalent to
The one way synonyms API is available at http://ac.cnstrc.com/v2/one_way_synonyms (note