Retrieve collection item URL

get

https://offsite-discovery.cnstrc.com/v1/browse/collection_id/{collection_id}/positions/{position}/url

Redirects to a collection item PDP URL or returns JSON based on its collection ID and position in a collection result set (collection_id and position as path parameters).

Path Params

collection_id

string

required

The unique identifier of the collection containing the product set.

position

integer

required

≥ 1

The position of the desired product within the results.

Query Params

key

string

required

length between 1 and 100

The key of the index to use.

campaign_id

string

required

Email campaign identifier for tracking and analytics.

filters

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_name

string

deprecated

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_value

string

deprecated

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

num_results

integer

1 to 100

Defaults to 10

The maximum number of collection items to retrieve.

sort_by

string

Defaults to relevance

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

sort_order

string

enum

Defaults to descending

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

Allowed:

string

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

array | 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.

string

Unique identifier for the user to personalize recommendation results.

base_url

string

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

format

string

enum

Defaults to redirect

Format of the response, either 'redirect' (default for 302 redirect) or 'json' (for 200 OK with JSON body for debugging).

Allowed:

Responses

👋 Welcome to Constructor's new and improved documentation

200OK - JSON response with URL resource details (if format=json).

302Found - Redirects to the product detail page.

400Bad Request - Invalid syntax or missing required parameters.

404Not Found - The requested resource could not be found based on the provided parameters, possibly due to expired recommendations or out-of-range position.

500Internal Server Error - An unexpected error occurred on the server.