Browse API: Browse Category Page
Fetch, filter, sort, and paginate merchandised category pages in your catalog using our powerful browse api.
curl --request POST \
--url https://app.uselayers.com/api/storefront/v1/browse/{collectionHandle} \
--header 'Accept: <accept>' \
--header 'Content-Type: <content-type>' \
--header 'X-Storefront-Access-Token: <x-storefront-access-token>' \
--data '{
"sort_order_code": "<string>",
"filter_group": {},
"pagination": {
"page": 123,
"limit": 123
},
"facets": [
"<string>"
],
"retrieveFacetCount": true,
"userToken": "<string>",
"identity": {
"sessionId": "<string>",
"customerId": "<string>"
},
"context": {
"path": "<string>",
"referrer_path": "<string>",
"marketing_source": "<string>",
"marketing_medium": "<string>",
"marketing_campaign": "<string>",
"marketing_term": "<string>",
"marketing_content": "<string>",
"cart_empty": true,
"cart_value": 123,
"num_cart_items": 123,
"signed_in": true,
"num_orders": 123,
"geo_city": "<string>",
"geo_state": "<string>",
"geo_country": "<string>"
},
"attributes": [
"<string>"
]
}'{
"results": [
{
"id": 7003338965178,
"title": "SUPREME SEALLINE SEE POUCH SMALL",
"body_html": "The Supreme Sealline See Pouch Small is a versatile and waterproof storage solution that seamlessly marries utility and style. With its clear window for easy visibility and the iconic Supreme branding, it's a sought-after accessory for those who appreciate keeping their essentials dry while making a fashion statement, whether at the beach or in the city..",
"vendor": "SUPREME",
"product_type": "Accessories",
"created_at": 1644047925,
"handle": "supreme-pouch-44370ss18a32-sm",
"updated_at": 1698280024,
"published_at": 1644047925,
"tags": [
"consignment",
],
"images": [
{
"alt": "SUPREME POUCH",
"src": "https://cdn.shopify.com/s/files/1/0588/3677/9194/products/ss18_supreme_tnf_pouch_blk_2-l_5fb1316e-22f7-4702-9953-57f3fbdda5be.jpg?v=1644047927",
"width": 800,
"height": 534,
"variant_ids": []
}
],
"metafields": {
"product": {
"alias": "SEALLINE SEE POUCH SMALL",
"colorway": "BLACK",
"styleCode": "SS18A30 BLACK",
"yearOfRelease": 2018,
"searchColor": [
"black"
]
}
},
"collection_ids": [
287488868538
],
"collection_handles": [
"supreme"
],
"available": true,
"price_range": {
"from": 30,
"to": 30
}
}
],
"totalResults": 1000,
"page": 1,
"totalPages": 20,
"facets": {
"vendor": {
"ADIDAS": 30,
"JORDAN": 336,
"NEW BALANCE": 15,
"NIKE": 384,
"REEBOK": 4,
"SUPREME": 624,
"VANS": 32
}
},
"attributionToken": "2y10smI2dB7XZXXFJsLUELltgueq8NRdcRD3U8djkLqxQmaVMvg1lSCf2"
}
Authorization
Token-based authentication header in the form of <YOUR_LAYERS_TOKEN>.
Headers
Path Parameters
The handle of the collection you wish to browse.
Body
Code of the sort order.
Refer to our dedicated Filter Expressions guide to learn more about filter expressions.
Facets to be included.
If the count of each facet value should be calculated
User’s unique token (optional).
Anonymous contextual information of the session/customer.
The path of the page the user is on (e.g., /collections/all-products).
The referrer path of the previous page the user visited.
The source of the UTM tracking for the current session.
The medium of the UTM tracking (e.g., email, CPC).
The campaign associated with the UTM tracking.
The term or keyword used in UTM tracking.
The content description used in UTM tracking.
Indicates whether the user’s cart is empty.
The total value of the items in the user’s cart.
The number of items in the user’s cart.
Indicates whether the user is signed in.
The total number of orders made by the user.
The city associated with the user’s context.
The state or province associated with the user’s context.
The country associated with the user’s context.
Product attributes to include in the Response. By default all attributes are included in the response.
Response
The unique identifier of the product.
The title of the product.
The HTML content describing the product.
The vendor of the product.
The type of the product.
The timestamp when the product was created.
The handle of the product.
The timestamp when the product was updated.
The timestamp when the product was published.
The tags associated with the product.
The metafields of the product.
The collection IDs associated with the product.
The collection handles associated with the product.
The availability of the product.
The total number of results.
The current page number.
The total number of pages.
If retrieveFacetCount is true then an object with keys and values of the specified attributes.
The attribution token.
{
"results": [
{
"id": 7003338965178,
"title": "SUPREME SEALLINE SEE POUCH SMALL",
"body_html": "The Supreme Sealline See Pouch Small is a versatile and waterproof storage solution that seamlessly marries utility and style. With its clear window for easy visibility and the iconic Supreme branding, it's a sought-after accessory for those who appreciate keeping their essentials dry while making a fashion statement, whether at the beach or in the city..",
"vendor": "SUPREME",
"product_type": "Accessories",
"created_at": 1644047925,
"handle": "supreme-pouch-44370ss18a32-sm",
"updated_at": 1698280024,
"published_at": 1644047925,
"tags": [
"consignment",
],
"images": [
{
"alt": "SUPREME POUCH",
"src": "https://cdn.shopify.com/s/files/1/0588/3677/9194/products/ss18_supreme_tnf_pouch_blk_2-l_5fb1316e-22f7-4702-9953-57f3fbdda5be.jpg?v=1644047927",
"width": 800,
"height": 534,
"variant_ids": []
}
],
"metafields": {
"product": {
"alias": "SEALLINE SEE POUCH SMALL",
"colorway": "BLACK",
"styleCode": "SS18A30 BLACK",
"yearOfRelease": 2018,
"searchColor": [
"black"
]
}
},
"collection_ids": [
287488868538
],
"collection_handles": [
"supreme"
],
"available": true,
"price_range": {
"from": 30,
"to": 30
}
}
],
"totalResults": 1000,
"page": 1,
"totalPages": 20,
"facets": {
"vendor": {
"ADIDAS": 30,
"JORDAN": 336,
"NEW BALANCE": 15,
"NIKE": 384,
"REEBOK": 4,
"SUPREME": 624,
"VANS": 32
}
},
"attributionToken": "2y10smI2dB7XZXXFJsLUELltgueq8NRdcRD3U8djkLqxQmaVMvg1lSCf2"
}
Was this page helpful?
curl --request POST \
--url https://app.uselayers.com/api/storefront/v1/browse/{collectionHandle} \
--header 'Accept: <accept>' \
--header 'Content-Type: <content-type>' \
--header 'X-Storefront-Access-Token: <x-storefront-access-token>' \
--data '{
"sort_order_code": "<string>",
"filter_group": {},
"pagination": {
"page": 123,
"limit": 123
},
"facets": [
"<string>"
],
"retrieveFacetCount": true,
"userToken": "<string>",
"identity": {
"sessionId": "<string>",
"customerId": "<string>"
},
"context": {
"path": "<string>",
"referrer_path": "<string>",
"marketing_source": "<string>",
"marketing_medium": "<string>",
"marketing_campaign": "<string>",
"marketing_term": "<string>",
"marketing_content": "<string>",
"cart_empty": true,
"cart_value": 123,
"num_cart_items": 123,
"signed_in": true,
"num_orders": 123,
"geo_city": "<string>",
"geo_state": "<string>",
"geo_country": "<string>"
},
"attributes": [
"<string>"
]
}'{
"results": [
{
"id": 7003338965178,
"title": "SUPREME SEALLINE SEE POUCH SMALL",
"body_html": "The Supreme Sealline See Pouch Small is a versatile and waterproof storage solution that seamlessly marries utility and style. With its clear window for easy visibility and the iconic Supreme branding, it's a sought-after accessory for those who appreciate keeping their essentials dry while making a fashion statement, whether at the beach or in the city..",
"vendor": "SUPREME",
"product_type": "Accessories",
"created_at": 1644047925,
"handle": "supreme-pouch-44370ss18a32-sm",
"updated_at": 1698280024,
"published_at": 1644047925,
"tags": [
"consignment",
],
"images": [
{
"alt": "SUPREME POUCH",
"src": "https://cdn.shopify.com/s/files/1/0588/3677/9194/products/ss18_supreme_tnf_pouch_blk_2-l_5fb1316e-22f7-4702-9953-57f3fbdda5be.jpg?v=1644047927",
"width": 800,
"height": 534,
"variant_ids": []
}
],
"metafields": {
"product": {
"alias": "SEALLINE SEE POUCH SMALL",
"colorway": "BLACK",
"styleCode": "SS18A30 BLACK",
"yearOfRelease": 2018,
"searchColor": [
"black"
]
}
},
"collection_ids": [
287488868538
],
"collection_handles": [
"supreme"
],
"available": true,
"price_range": {
"from": 30,
"to": 30
}
}
],
"totalResults": 1000,
"page": 1,
"totalPages": 20,
"facets": {
"vendor": {
"ADIDAS": 30,
"JORDAN": 336,
"NEW BALANCE": 15,
"NIKE": 384,
"REEBOK": 4,
"SUPREME": 624,
"VANS": 32
}
},
"attributionToken": "2y10smI2dB7XZXXFJsLUELltgueq8NRdcRD3U8djkLqxQmaVMvg1lSCf2"
}