Products
Product catalog endpoints
Get latest products
Authorization
ApiKeyAuth API key is automatically provided for demo requests in the playground
In: header
Query Parameters
Number of products to return
1 <= value <= 100Response Body
application/json
application/json
curl -X GET "https://test.putiikkipalvelu.fi/api/storefront/v1/latest-products?take=6"[
{
"id": "clx123abc",
"name": "Gold Ring",
"slug": "gold-ring",
"description": "string",
"price": 15000,
"images": [
"http://example.com"
],
"quantity": 0,
"salePrice": 12000,
"salePercent": "20",
"saleStartDate": "2019-08-24T14:15:22Z",
"saleEndDate": "2019-08-24T14:15:22Z",
"variations": [
{
"id": "clx456def",
"price": 15000,
"salePrice": 12000,
"salePercent": "20",
"saleStartDate": "2019-08-24T14:15:22Z",
"saleEndDate": "2019-08-24T14:15:22Z"
}
]
}
]{
"error": "Error message"
}Get product by slug
Authorization
ApiKeyAuth API key is automatically provided for demo requests in the playground
In: header
Path Parameters
Product URL slug
Response Body
application/json
application/json
application/json
curl -X GET "https://test.putiikkipalvelu.fi/api/storefront/v1/product/gold-ring"{
"id": "clx123abc",
"name": "Gold Ring",
"slug": "gold-ring",
"description": "string",
"price": 15000,
"images": [
"http://example.com"
],
"quantity": 0,
"salePrice": 12000,
"salePercent": "20",
"saleStartDate": "2019-08-24T14:15:22Z",
"saleEndDate": "2019-08-24T14:15:22Z",
"variations": [
{
"id": "clx456def",
"price": 15000,
"salePrice": 12000,
"salePercent": "20",
"saleStartDate": "2019-08-24T14:15:22Z",
"saleEndDate": "2019-08-24T14:15:22Z",
"weight": 0.3,
"quantity": 0,
"sku": "string",
"images": [
"http://example.com"
],
"description": "string",
"showOnStore": true,
"options": [
{
"value": "Large",
"optionType": {
"name": "Size"
}
}
]
}
],
"weight": 0.5,
"sku": "string",
"metaTitle": "string",
"metaDescription": "string",
"categories": [
{
"id": "string",
"name": "string",
"slug": "string",
"parentId": "string"
}
],
"ticketInfo": {
"id": "clx789ticket",
"requiresHolder": false,
"maxUses": 1
}
}{
"error": "Error message"
}{
"error": "Error message"
}Get product count
Authorization
ApiKeyAuth API key is automatically provided for demo requests in the playground
In: header
Query Parameters
Category slug hierarchy. Omit or use "all-products" for all products. The last slug in the array is used as the category filter.
Response Body
application/json
curl -X GET "https://test.putiikkipalvelu.fi/api/storefront/v1/products-count?slugs=jewelry%2Crings"{
"count": 42
}Get sorted products with pagination and search
Authorization
ApiKeyAuth API key is automatically provided for demo requests in the playground
In: header
Query Parameters
Full-text search query. Supports prefix matching (e.g., "sor" matches "sormus").
Multiple words use AND logic (all must match). When provided, default sort is relevance.
length <= 200Category slug hierarchy. Omit or use "all-products" for all products.
Can be combined with q to search within a category.
Page number (1-based)
11 <= valueProducts per page
121 <= value <= 100Sort order. Default is newest, or relevance when q is provided.
relevance ranks by how well products match the search query.
"newest""newest" | "price_asc" | "price_desc" | "popularity" | "relevance"Response Body
application/json
application/json
application/json
curl -X GET "https://test.putiikkipalvelu.fi/api/storefront/v1/sorted-products?slugs=jewelry%2Crings"{
"name": "Korut",
"products": [
{
"id": "clx123abc",
"name": "Gold Ring",
"slug": "gold-ring",
"description": "string",
"price": 15000,
"images": [
"http://example.com"
],
"quantity": 0,
"salePrice": 12000,
"salePercent": "20",
"saleStartDate": "2019-08-24T14:15:22Z",
"saleEndDate": "2019-08-24T14:15:22Z",
"variations": [
{
"id": "clx456def",
"price": 15000,
"salePrice": 12000,
"salePercent": "20",
"saleStartDate": "2019-08-24T14:15:22Z",
"saleEndDate": "2019-08-24T14:15:22Z"
}
]
}
],
"totalCount": 42
}{
"error": "Error message"
}{
"error": "Error message"
}