v1

latestOpenAPI 3.1.02026-07-241765501.1 MB

Offsite Discovery results

Retrieve recommendations by collection

Retrieve AI-optimized products from a specified collection

get/v1/browse/collection_id/{collection_id}

Path parameters

collection_idstring required

The unique identifier of the collection containing the product set.

Example:summer_collection

The unique identifier of the collection containing the product set.

Query parameters

keystring required

The key of the index to use.

Example:ZqXaOfXuBWD4s3XzCI1q

The key of the index to use.

campaign_idstring required

Email campaign identifier for tracking and analytics.

Example:email_campaign_2024_01

Email campaign identifier for tracking and analytics.

object

Any number of filtering criteria used to narrow the result set, such as color=blue or group_id=sandals or price=100-200. Facets, item groups and collection IDs can be used as filters. If filter_value has the form <min>-<max>, it is interpreted as a range. Filters with the same key are ORed together and filters with different keys are ANDed together by default. Only results that match the filters are returned. Boolean values are serialized with the first letter capitalized (e.g., True / False) as a convention.

filter_namestring

DEPRECATED. Please, use 'filters' instead. Name of the product attribute to filter by (e.g., brand, category, color). Must be provided together with filter_value.

Example:brand

DEPRECATED. Please, use 'filters' instead. Name of the product attribute to filter by (e.g., brand, category, color). Must be provided together with filter_value.

filter_valuestring

DEPRECATED. Please, use 'filters' instead. Value to filter the specified attribute by. Must be provided together with filter_name.

Example:nike

DEPRECATED. Please, use 'filters' instead. Value to filter the specified attribute by. Must be provided together with filter_name.

num_resultsinteger

The maximum number of collection items to retrieve.

Example:10

The maximum number of collection items to retrieve.

sort_bystring

The method to sort results by. The default value relevance sorts by Constructor's attractiveness & personalization algorithms and is reserved. Alternative sort criteria can be configured using the sort options

Example:relevance

sort_order'ascending' | 'descending'

The sort order for results: ascending (low to high) or descending (high to low).

The order by which results should be sorted. Only valid in conjunction with sort_by.

cstring

The ID of the client and version that the request is coming from, such as cio-js-2.90.

Example:cio-dashboard

The ID of the client and version that the request is coming from, such as cio-js-2.90.

string[]

string

User segment is a client context value (such as platform, location, etc.) that is used to evaluate redirect or refined tag rules. You can supply multiple segments by passing multiple us arguments.

uistring

Unique identifier for the user to personalize recommendation results.

Example:user_12345

Unique identifier for the user to personalize recommendation results.

base_urlstring

Base URL used to construct the product detail page redirect URL (e.g., 'https://example.com').

Response

OK. A list of products from a specified collection.

valuestring

The name or title of the product (corresponds to item_name from OpenAPI example).

Example response

[
  {
    "data": {
      "id": "PROD123",
      "variation_id": "VAR456",
      "url": "https://example.com/products/prod123",
      "image_url": "https://example.com/images/prod123.jpg"
    },
    "value": "Classic Blue T-Shirt",
    "strategy": {
      "id": "bestsellers"
    },
    "labels": {
      "is_retail_media": true,
      "sl_campaign_id": "campaign_123",
      "sl_campaign_owner": "brand_abc"
    }
  }
]