Search
The Search module provides product discovery for storefront-facing applications. It supports keyword search, faceted filters, autocomplete suggestions, product listing pages backed by Vertex AI retail search, display banner ads, and product recommendations.
Product recommendation operations — placement-based, batch similar, widget, curated, personalised category, trends, and user filters.
Operations
GET
# Placement-based product recommendations.
POST
# Batch similar-product lookup.
GET
# User-personalised product widget.
GET
# Editorial/curated widget.
GET
# Personalised category page.
GET
# Top trends for cohort, segment, or brick.
GET
# User filter affinities.
FDK Method Name: getRecommendations
Returns placement-based product recommendations for a storefront visitor. The backend (Vertex Predict or RRA) is determined per placement_type via the PLACEMENT_BACKEND_* environment variables — no global feature flag. Returns a single flat product list. Always returns HTTP 200 — failures degrade to an empty items array with metadata.fallback=true.
Parameters
placement_type
string
Required
Recommendation placement key that determines the model to invoke (e.g. similar-products, recently-viewed, bought-together).
visitor_id
string
Required
Storefront visitor ID. Used by Vertex for personalisation context and by RRA for session scoping.
product_id
string
Single seed product ID. Mutually exclusive with product_ids.
product_ids
string
Comma-separated seed product IDs. Mutually exclusive with product_id. Results are merged into a single flat list.
page_size
integer
Number of recommended products to return (max 50).
Default Value : 10
filter
string
Vertex filter expression to narrow recommendation results.
pincode
string
Delivery pincode for price zone resolution.
Response
200
400
Success. Returns a flat list of recommended products. Empty items array on fallback (circuit open, timeout, or no results).
RecommendationListing
items
array of object (RecommendedProductItem)
Flat list of recommended products. Empty array on fallback.
Array of RecommendedProductItem
uid
integer
Unique product identifier.
name
string
Product display name.
slug
string
URL-safe product identifier.
brand
object
Brand name and UID.
price
object
Effective and marked price bands.
medias
array of object
Product images.
sellable
boolean
Whether the product is currently purchasable.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
page
object (StandardPage)
StandardPage
current
integer
Current page number (1-indexed).
total
integer
Nullable
Total number of pages. null for cursor-based (open-ended) endpoints.
has_previous
boolean
Whether a previous page exists.
has_next
boolean
Whether a next page exists.
item_total
integer
Total number of items on the current page.
type
string
Pagination mode.
Enum
next_id
string
Cursor token for the next page. Only present when type=cursor and has_next=true.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
metadata
object (RecommendationListingMetadata)
RecommendationListingMetadata
placement_type
string
Echoes the requested placement_type.
attribution_token
string
Vertex attribution token for downstream event logging. Empty string when RRA backend is active.
missing_ids
array of string
Seed product IDs that were not found in productMaster.
fallback
boolean
Present and true only when a fallback response is returned.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Placement-based product recommendations.
getRecommendations
FDK Method Name: getSimilarProducts
Takes N seed products and returns N separate similar-product lists — one per seed. Use this for cart-page and multi-product contexts where results must stay grouped by their origin product. Always uses RRA backend. Always returns HTTP 200.
Parameters
No Parameters
Request body
products
array of object (SimilarBatchProduct)
Required
Array of seed product entries. At least one entry required.
Minimum Items : 1
Array of SimilarBatchProduct
product_id
string
Required
Seed product ID.
store
string
Store / channel key for RRA routing. Defaults to the application ID when omitted.
size
integer
Max number of similar products for this seed. Defaults to RRA_MAX_PER_PRODUCT server config.
pincode
string
Delivery pincode for price zone resolution.
Response
200
400
Success. Returns one grouped entry per seed product, each containing its similar products list. Empty similar array for seeds with no results.
SimilarBatchListing
items
array of object (SimilarBatchItem)
One entry per seed product containing its similar products. Empty array on fallback.
Array of SimilarBatchItem
product_id
string
The seed product ID echoed from the request.
similar
array of object (RecommendedProductItem)
Similar products for this seed. Empty array when none found.
Array of RecommendedProductItem
uid
integer
Unique product identifier.
name
string
Product display name.
slug
string
URL-safe product identifier.
brand
object
Brand name and UID.
price
object
Effective and marked price bands.
medias
array of object
Product images.
sellable
boolean
Whether the product is currently purchasable.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
page
object (StandardPage)
StandardPage
current
integer
Current page number (1-indexed).
total
integer
Nullable
Total number of pages. null for cursor-based (open-ended) endpoints.
has_previous
boolean
Whether a previous page exists.
has_next
boolean
Whether a next page exists.
item_total
integer
Total number of items on the current page.
type
string
Pagination mode.
Enum
next_id
string
Cursor token for the next page. Only present when type=cursor and has_next=true.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
metadata
object (SimilarBatchListingMetadata)
SimilarBatchListingMetadata
fallback
boolean
true only when a fallback response is returned.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
Parameters are not required.
Was this section helpful?
POST
Response
Batch similar-product lookup.
getSimilarProducts
FDK Method Name: getWidgetRecommendations
Returns a flat product list personalised to the user for a given widget placement via RRA. Supports a minimum-threshold guard — falls back to empty when RRA returns fewer products than configured. Always returns HTTP 200.
Parameters
widget_id
string
Required
Widget placement identifier configured in RRA.
widget_type
string
Required
Widget type key (e.g. personalised, trending).
store
string
Required
Store / channel key.
page_size
integer
Number of products to return (max 50).
Default Value : 20
pincode
string
Delivery pincode for price zone resolution.
show_default_if_no_data
boolean
When true, return default/trending content if no personalised data exists for the user in RRA.
Default Value : false
Response
200
400
Success. Returns a flat personalised product list. Empty items array when below minimum threshold or on fallback.
WidgetListing
items
array of object (RecommendedProductItem)
Personalised product list for the widget. Empty array on fallback.
Array of RecommendedProductItem
uid
integer
Unique product identifier.
name
string
Product display name.
slug
string
URL-safe product identifier.
brand
object
Brand name and UID.
price
object
Effective and marked price bands.
medias
array of object
Product images.
sellable
boolean
Whether the product is currently purchasable.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
page
object (StandardPage)
StandardPage
current
integer
Current page number (1-indexed).
total
integer
Nullable
Total number of pages. null for cursor-based (open-ended) endpoints.
has_previous
boolean
Whether a previous page exists.
has_next
boolean
Whether a next page exists.
item_total
integer
Total number of items on the current page.
type
string
Pagination mode.
Enum
next_id
string
Cursor token for the next page. Only present when type=cursor and has_next=true.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
metadata
object (WidgetListingMetadata)
WidgetListingMetadata
widget_id
string
Echoes the requested widget_id.
fallback
boolean
Present and true only when a fallback response is returned.
below_threshold
boolean
Present and true when RRA returned fewer results than the configured minimum threshold.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
User-personalised product widget.
getWidgetRecommendations
FDK Method Name: getCuratedRecommendations
Returns curated content items (images + filter sets) from RRA for hand-picked landing strip widgets. Items are editorial content, not hydrated products. Items with no images are filtered out. Always returns HTTP 200.
Parameters
widget_id
string
Required
Curated widget identifier configured in RRA.
widget_level
string
Required
Widget hierarchy level (e.g. brand, category, global).
store
string
Required
Store / channel key.
show_default_if_no_data
boolean
Return default content if no curated data exists for this widget.
Default Value : false
Response
200
400
Success. Returns curated editorial items. Items with no images are excluded. Empty items array on fallback.
CuratedListing
items
array of object (CuratedItem)
Curated editorial items. Empty array on fallback.
Array of CuratedItem
widget_item_id
string
Unique identifier for this curated item.
title
string
Editorial headline / title.
images
array of object
Images associated with this curated item.
filters
string
JSON-serialised filter map for navigating to the curated product set. Clients should JSON.parse this before use.
rank
integer
Display rank / order of this item within the widget.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
page
object (StandardPage)
StandardPage
current
integer
Current page number (1-indexed).
total
integer
Nullable
Total number of pages. null for cursor-based (open-ended) endpoints.
has_previous
boolean
Whether a previous page exists.
has_next
boolean
Whether a next page exists.
item_total
integer
Total number of items on the current page.
type
string
Pagination mode.
Enum
next_id
string
Cursor token for the next page. Only present when type=cursor and has_next=true.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
metadata
object (CuratedListingMetadata)
CuratedListingMetadata
widget_id
string
Echoes the requested widget_id.
fallback
boolean
Present and true only when a fallback response is returned.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Editorial/curated widget.
getCuratedRecommendations
FDK Method Name: getPersonalizedRecommendations
Cohort-targeted category listing. Blends RRA exploit, coldstart, and Vertex explore buckets into a paginated product listing. Supports cursor-based pagination — pass the page.next_id value as page_id to retrieve the next page. Always returns HTTP 200.
Parameters
primary_cohort
string
Required
Primary cohort tag driving personalisation (e.g. sports-enthusiast).
category_id
string
Required
Category identifier to personalise (e.g. footwear).
store
string
Required
Store / channel key.
page_size
integer
Products per page (max 50).
Default Value : 20
pincode
string
Delivery pincode for price zone resolution.
offset
string
Opaque cursor token from the previous response page.next_id to retrieve the next page of personalised results.
Response
200
400
Success. Returns a blended personalised product listing with cursor pagination. Use page.next_id as page_id for subsequent pages. Empty items array on fallback.
PersonalizedListing
items
array of object (RecommendedProductItem)
Blended personalised product listing (exploit + coldstart + explore buckets). Empty array on fallback.
Array of RecommendedProductItem
uid
integer
Unique product identifier.
name
string
Product display name.
slug
string
URL-safe product identifier.
brand
object
Brand name and UID.
price
object
Effective and marked price bands.
medias
array of object
Product images.
sellable
boolean
Whether the product is currently purchasable.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
page
object (StandardPage)
StandardPage
current
integer
Current page number (1-indexed).
total
integer
Nullable
Total number of pages. null for cursor-based (open-ended) endpoints.
has_previous
boolean
Whether a previous page exists.
has_next
boolean
Whether a next page exists.
item_total
integer
Total number of items on the current page.
type
string
Pagination mode.
Enum
next_id
string
Cursor token for the next page. Only present when type=cursor and has_next=true.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
metadata
object
Personalisation metadata. Empty object on a successful response. Contains fallback=true on a degraded response.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Personalised category page.
getPersonalizedRecommendations
FDK Method Name: getTopTrendsRecommendations
Returns trending product option codes for the given grouping level (Cohort, Segment, or Brick) from RRA. Always returns HTTP 200.
Parameters
type
string
Required
Trend grouping level.
Enum
value
string
Required
Grouping value (e.g. "premium", "Men", "Men - Shirts").
store
string
Required
Store / channel key.
Response
200
400
Success. Returns trend IDs. Empty trends array on fallback.
TrendsResult
trends
array of string
Trending option code IDs. Empty array on fallback.
metadata
object
Trend metadata (type, value, store, timestamp). Contains fallback=true on degraded response.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Top trends for cohort, segment, or brick.
getTopTrendsRecommendations
FDK Method Name: getUserFiltersRecommendations
Returns per-user filter preferences (brand, discount, category) from RRA. Always returns HTTP 200.
Parameters
user_id
string
Required
User identifier.
store
string
Required
Store / channel key.
Response
200
400
Success. Returns filter affinities. Empty filters object on fallback.
UserFiltersResult
filters
object
Per-user filter affinities. Keys are filter dimensions (brand, discount, l1l3nestedcategory), values are arrays of preferred values. Empty object on fallback.
metadata
object
Filter metadata (userId, store, timestamp). Contains fallback=true on degraded response.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
User filter affinities.
getUserFiltersRecommendations
Operations
GET
# Lists all products.
GET
# Browse products belonging to a collection.
GET
# Get filter configuration.
GET
# Visual image-based product search.
GET
# Retrieves search result listings.
FDK Method Name: getProducts
List all products available in the catalog. Supports filtering based on product name, brand, department, category, collection, and more, with sorting options based on price, ratings, discounts, and other criteria.
**Sponsored product injection:** When Osmos PLA ads are available, sponsored products are injected into the items array at configurable intervals (default: positions 4, 7, 10, 13 — 1-indexed). Sponsored items carry `sponsored: true` and a `ad_meta` tracking block alongside all standard product fields. Organic and sponsored products are otherwise identical in shape — clients must check `sponsored` to distinguish them.
Parameters
q
string
The search query for entering partial or full name of product, brand, category, or collection.
f
string
The search filter parameters. Filter parameters will be passed in f parameter as shown in the example below. Double Pipe (||) denotes the OR condition, whereas Triple-colon (:::) indicates a new filter parameter applied as an AND condition.
filters
boolean
True for fetching all filter parameters and False for disabling the filter parameters.
Default Value : true
sort_on
string
The order in which the list of products should be sorted, e.g. popularity, price, latest and discount, in either ascending or descending order. See the supported values below.
Enum
page_id
string
Page ID to retrieve next set of results.
page_size
integer
The number of items to retrieve in each page.
Default Value : 12
page_no
integer
The page number to navigate through the given set of results.
Default Value : 1
page_type
string
Available pagination types are cursor or number.
Default Value : cursor
Enum
store_ids
string
Comma-separated store / channel IDs (e.g. "AJIO,AJIO_INTL")
more_filter_categories
string
Comma-separated list of category slugs whose category-specific "More Filters" should be included in the response filters array. Each matching filter carries `is_more_filter: true` and `category_slug` so the UI can render them in a separate section. Max 3 slugs are evaluated per request.
Response
200
Success. Returns a paginated list of products.
SearchProductListing
items
array of object (SearchProductItem)
Paginated list of organic and sponsored product items.
Array of SearchProductItem
uid
integer
Unique product identifier.
name
string
Product display name.
slug
string
URL-safe product identifier.
item_type
string
Always "standard" for PRIMARY-type catalog.
sellable
boolean
Whether the product is currently purchasable.
discount
string
Formatted discount string (e.g. "20% OFF"). Empty string when no discount.
brand
object
Brand name, uid, logo, and navigation action.
price
object
Price object with effective, marked, and selling legs. Each leg has min/max/currency_code/currency_symbol.
medias
array of object
Product images (type=image, url).
action
object
Navigation action for deep-linking to the product detail page.
_custom_json
object
Arbitrary key-value metadata from the catalog.
tags
array of string
Product tags from the catalog (e.g. "Single", "Mass"). Empty array when no tags are present.
sponsored
boolean
Present and true only for Osmos PLA sponsored products injected into the listing. Absent on organic products.
ad_meta
object (AdMeta)
AdMeta
uclid
string
Unique click link ID for Osmos impression/click tracking.
mcid
string
Merchant click ID.
sclid
string
Search click link ID.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
primary_urgency_tag
object (UrgencyTag)
Nullable
Highest-priority urgency tag for this product, resolved by the tag engine at search time. Present only when TAG_ENGINE_ENABLED=true and the tag engine returns a tag for this product. null when no urgency tag applies.
UrgencyTag
tag_name
string
Internal tag identifier used for filtering and analytics.
short_text
string
Display label shown on the product card badge.
icon_url
string
CDN URL of the badge icon to render on the product card.
position
string
Nullable
Tag placement position returned by the tag engine (e.g. "TOP"). Indicates where on the product card the badge should be rendered. null if the tag engine does not specify a position.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
filters
array of object (SearchFilterItem)
Active faceted filters available for this result set. Each filter has a `key` object (display, name, kind, logo) and a `values` array. When `more_filter_categories` is requested, matching category-specific filters carry `is_more_filter: true` and `category_slug` so the UI can render them in a separate "More Filters" section.
Array of SearchFilterItem
key
object (SearchFilterKey)
SearchFilterKey
display
string
Human-readable display name for the filter.
name
string
Machine-readable filter identifier.
kind
string
Filter interaction type.
Enum
logo
string
Nullable
Optional logo URL for the filter.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
values
array of object
Available filter values for this key.
is_more_filter
boolean
Present and true when this filter originates from a category-specific "More Filters" config (requested via more_filter_categories query param).
category_slug
string
The category slug this filter belongs to. Only present when is_more_filter is true.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
page
object
Pagination metadata for the current result page.
sort_on
array of object
Available sort options for the result set.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Lists all products.
getProducts
FDK Method Name: getCollectionProducts
Returns a paginated product listing filtered to the given collection slug. Supports both handpick and rules-based collections — the Vertex filter expression is resolved by the collection service; this endpoint has no branching logic.
Parameters
slug
string
Required
Collection slug identifier (e.g. summer-sale, new-arrivals).
f
string
Filter string — same format as /products (key:val:::key:val).
sort_on
string
Sort key — same values as /products.
Enum
page_id
string
Cursor token for the next page.
page_size
integer
Number of results per page.
Default Value : 12
page_no
integer
Page number (1-indexed).
Default Value : 1
page_type
string
Pagination mode — cursor or number.
Default Value : cursor
Enum
store_ids
string
Comma-separated store / channel IDs (e.g. "AJIO,AJIO_INTL")
more_filter_categories
string
Comma-separated category slugs for "More Filters" — same behavior as the /products endpoint.
Response
200
404
Success. Returns a paginated product listing for the collection.
SearchProductListing
items
array of object (SearchProductItem)
Paginated list of organic and sponsored product items.
Array of SearchProductItem
uid
integer
Unique product identifier.
name
string
Product display name.
slug
string
URL-safe product identifier.
item_type
string
Always "standard" for PRIMARY-type catalog.
sellable
boolean
Whether the product is currently purchasable.
discount
string
Formatted discount string (e.g. "20% OFF"). Empty string when no discount.
brand
object
Brand name, uid, logo, and navigation action.
price
object
Price object with effective, marked, and selling legs. Each leg has min/max/currency_code/currency_symbol.
medias
array of object
Product images (type=image, url).
action
object
Navigation action for deep-linking to the product detail page.
_custom_json
object
Arbitrary key-value metadata from the catalog.
tags
array of string
Product tags from the catalog (e.g. "Single", "Mass"). Empty array when no tags are present.
sponsored
boolean
Present and true only for Osmos PLA sponsored products injected into the listing. Absent on organic products.
ad_meta
object (AdMeta)
AdMeta
uclid
string
Unique click link ID for Osmos impression/click tracking.
mcid
string
Merchant click ID.
sclid
string
Search click link ID.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
primary_urgency_tag
object (UrgencyTag)
Nullable
Highest-priority urgency tag for this product, resolved by the tag engine at search time. Present only when TAG_ENGINE_ENABLED=true and the tag engine returns a tag for this product. null when no urgency tag applies.
UrgencyTag
tag_name
string
Internal tag identifier used for filtering and analytics.
short_text
string
Display label shown on the product card badge.
icon_url
string
CDN URL of the badge icon to render on the product card.
position
string
Nullable
Tag placement position returned by the tag engine (e.g. "TOP"). Indicates where on the product card the badge should be rendered. null if the tag engine does not specify a position.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
filters
array of object (SearchFilterItem)
Active faceted filters available for this result set. Each filter has a `key` object (display, name, kind, logo) and a `values` array. When `more_filter_categories` is requested, matching category-specific filters carry `is_more_filter: true` and `category_slug` so the UI can render them in a separate "More Filters" section.
Array of SearchFilterItem
key
object (SearchFilterKey)
SearchFilterKey
display
string
Human-readable display name for the filter.
name
string
Machine-readable filter identifier.
kind
string
Filter interaction type.
Enum
logo
string
Nullable
Optional logo URL for the filter.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
values
array of object
Available filter values for this key.
is_more_filter
boolean
Present and true when this filter originates from a category-specific "More Filters" config (requested via more_filter_categories query param).
category_slug
string
The category slug this filter belongs to. Only present when is_more_filter is true.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
page
object
Pagination metadata for the current result page.
sort_on
array of object
Available sort options for the result set.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Browse products belonging to a collection.
getCollectionProducts
FDK Method Name: getFilterConfig
Returns the base filter configuration (from catalog Redis) merged with Phoenix overrides, plus category-specific filter mappings for the "More Filters" UX. Lightweight endpoint — Redis/Mongo only, no Vertex call.
Parameters
No Parameters
Response
200
400
Success. Returns primary and category filter configurations.
FilterConfigResult
data
object (FilterConfigData)
FilterConfigData
primary_filters
array of object (FilterConfigPrimaryFilter)
Base filters sorted by priority.
Array of FilterConfigPrimaryFilter
key
string
Filter attribute key.
display_name
string
Human-readable display name.
kind
string
Filter interaction type.
logo
string
Nullable
Optional logo URL.
priority
integer
Sort priority for display ordering.
_source
string
Origin of this filter config — "catalog" or "phoenix".
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
category_filters
array of object (FilterConfigCategoryFilter)
Category-specific filter groups for "More Filters" UX.
Array of FilterConfigCategoryFilter
slug
string
Category slug identifier.
name
string
Category display name.
group
string
Nullable
Optional grouping label for the category filter set.
filters
array of object (FilterConfigCategoryFilterEntry)
Filters within this category group.
Array of FilterConfigCategoryFilterEntry
attribute_key
string
Attribute key for this filter.
display_name
string
Human-readable display name.
output_key
string
Key used in the filter output/query.
kind
string
Filter interaction type.
priority
integer
Sort priority for display ordering.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
error
object
Nullable
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Get filter configuration.
getFilterConfig
FDK Method Name: getImageSearchProducts
Search for visually similar products by uploading an image (image_name) or refining a prior search using a ViSenze image ID (im_id + box). Returns the same product listing shape as /products plus a visual block containing the ViSenze session ID and detected product types.
Parameters
image_name
string
GCS object name or public image URL for a new visual search.
im_id
string
ViSenze im_id from a prior image search response (refinement flow).
box
string
Bounding box "x1,y1,x2,y2" — required when im_id is provided.
store
string
ViSenze store key for per-store credential resolution.
f
string
Filter string — same format as /products (key:val:::key:val).
sort_on
string
Sort key — same values as /products.
Enum
page
integer
0-indexed page number.
Default Value : 0
page_size
integer
Results per page (max 100).
Default Value : 20
product_type
string
Detected product type tag (e.g. outerwear, shoe). Actual filtering uses im_id + box.
store_ids
string
Comma-separated store / channel IDs (e.g. "AJIO,AJIO_INTL")
Response
200
Success. Returns a paginated product listing with visual session metadata.
ImageSearchProductListing
items
array of object
Paginated list of visually similar product items.
filters
array of object
Active faceted filters available for this result set.
page
object
Pagination metadata for the current result page.
sort_on
array of object
Available sort options for the result set.
visual
object (VisualSearchBlock)
VisualSearchBlock
id
string
ViSenze session image ID for refinement flows.
product_types
array of object
List of detected product types with confidence scores and bounding boxes.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Visual image-based product search.
getImageSearchProducts
FDK Method Name: getAutoComplete
Get products, brands, or categories based on a search query, which can be a partial or full name match.
Parameters
q
string
Required
The search query for entering partial or full name of a product, brand or category. For example, if the given search query `q` is _ski_, the relevant search suggestions could be _skirt_, _ski shoes_, _skin cream_ etc.
store_ids
string
Comma-separated store / channel IDs (e.g. "AJIO,AJIO_INTL")
Response
200
Success. Returns a list of autocomplete suggestions for the search query `q`.
SearchAutoComplete
items
array of object
List of autocomplete suggestion items.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response