Skip to content

Ecommerce Search 26.0

Version 26.0
Release Date TBD

Upcoming Release

This version has not been released yet. The information on this page is subject to change.

Changes

Upgrade instructions

Unified Search response model changes

The return models for suggestions, didYouMean, relatedTags, and aiRelatedTags have changed from simple string arrays to object arrays.

Field V25 (old) V26 (new)
suggestions string[] { phrase, hits[] }[]
didYouMean string[] { phrase }[]
relatedTags string[] { phrase, hits[], tag }[]
aiRelatedTags string[] { phrase, hits[] }[]

See Unified Search - Breaking changes in V26 for more details and examples.

StringAttribute have been renamed to StringAttributes.

Export

The /export endpoint have changes so the number of returned values might not be consistent with the NumberOfReturnedProduct. But use the NextPageToken to see when the export is ended. Some responses might not contain any data at all.

StringAttribute have been renamed to StringAttributes.

CategoryName field is obsolete

Categories should be used instead. The key will be the categoryId, while the name will containt the categoryName.

ParameterType Boolean and Top are obsolete

The parameter types Boolean and Top are obsolete and have been removed. They have not been supported for a long time.

New features

None

Enhancements

None

New or updated endpoints (v26)

Admin Api

Endpoint Comment
POST /"segments/{segmentId}/allowed-filters/bulk The endpoint only allows existing fields. The CategoryName field has been obsoleted. Categories should be used instead.
POST /"segments/{segmentId}/scopes/{scopeId} The CategoryName field has been obsoleted. Categories should be used instead.

Search Api

Endpoint Comment
POST /search Response model updated for suggestions, didYouMean, relatedTags, and aiRelatedTags. StringAttribute have been renamed to StringAttributes.
POST /export Number of returned results might very. StringAttribute have been renamed to StringAttributes.

Deprecations

V24 is now out of service and will be removed soon.