Skip to main content
GET
Request product list
このエンドポイントは商品のリストを取得します。
categories または filters クエリパラメーターを使用しない場合、Kameleoon はレスポンスに filters オブジェクトを含めません。

クエリパラメーター

レスポンス

ブランドプロパティ

カテゴリフィールド

フィルタープロパティ

フィルター範囲フィールド

価格帯フィールド

商品フィールド

商品カテゴリのプロパティ

パラメータープロパティ

クエリパラメータ

did
string
必須

Device ID. Get this ID from the KameleoonProducts_device_id cookie. Retrieve it from the backend before calling this endpoint. Only provide did when using filters or algorithms that rely on historical device data, such as "Recently Viewed" or "Recommended for You."

sid
string
必須

Temporary user session ID. Get this ID from the KameleoonProducts_session_code cookie. Retrieve it from the backend before calling this endpoint. Only provide sid when using filters or algorithms that rely on historical user data, such as "Recently Viewed" or "Recommended for You."

shop_id
string
必須

Store Key. Find this in Recommendations > Settings > Store settings in the Kameleoon app. Contact your Customer Success Manager for the key if necessary.

limit
integer

Maximum number of results the API returns.

page
integer

Maximum number of pages the API returns.

locations
string[]

Comma-separated list of location IDs.

brands
string[]

Comma-separated list of brands for filtering.

merchants
string[]

Comma-separated list of merchants for filtering.

categories
string[]

Comma-separated list of categories for filtering.

filters
string

Escaped JSON string with filter parameters. Example: {"bluetooth":["yes"],"offers":["15% cashback"],"weight":["1.6"]}

filters_search_by
string

Filter search options: name, quantity, popularity.

レスポンス

200 - application/json

Matching products and facet information. Response shape verified against a live call on 2026-09-24.

brands
object[]

Brand facet information.

categories
object[]

Category facet information.

filters
object

A map of filter name (for example, "Color", "Size") to that filter's aggregation. Verified against a live response on 2026-09-24; the original reference documented filters as an array, but the API actually returns an object keyed by filter name.

price_range
object
products
object[]

Matching products.

products_total
integer

Total count of matching products.

price_ranges
object[]

Distribution of products across price ranges.

price_median
number

Median product price.