Basic information

POST /{shopId}/search/products

Performs a product search using facets.

Authorisation

OAuth 2.0 Token required with scopes:

products_write

URI parameters

Name Type Description
shopId string

The unique identifier of the shop.

Required: true
Example: DemoShop

Query parameters

Name Type Description
locale string

Represents the language code according to ISO 639-1 and the country code according to ISO 3166-1. If not provided, the shop’s default language is used. We recommend to always send this parameter with your request. If the default language had been changed in the administration, it might take up to 1 day until this change affects the shop.

Required: false
Example: en_US
page integer

Represents the current page.

Required: false
Default: 1
Minimum: 1
resultsPerPage integer

Specifies the maximum number of results per page.

Required: false
Default: 10
Maximum: 100

Request attributes

Name Type Description

object of productSearch (create request)

Request body

Media type application/json

{  
   "query":"headphone",
   "sortBy":"RELEVANCE",
   "attributeFilters":[  
      {  
         "attributeValue":null,
         "attributeRange":{  
            "min":1,
            "max":500
         },
         "fieldName":"ListPrice"
      },
      {  
         "attributeValue":22076,
         "fieldName":"CategoryID"
      },
      {  
         "attributeValue":"red",
         "fieldName":"PreDefString_de_67648890"
      }
   ]
}

Response attributes

Name Type Description
results

integer

The number of products in total found for the search query.

page

integer

The page number on which the found products appear.

resultsPerPage

integer

The number of found products returned per page.

items

array of productSearch

The list of all products found for the search query.

Response

HTTP 200

Media type application/json

{
    "results": 1,
    "page": 1,
    "resultsPerPage": 1,
    "items": [
      {
        "productId": "54EF2E41-FCA8-E0E5-9323-0A0C05E66C2E",
        "name": "Boom - Customised headphone",
        "visible": true,
        "productVariationType": "regular",
        "productVariationMasterName": null,
        "productVariationMasterId": null,
        "manufacturerProductNumber": "CU001",
        "productLength": null,
        "productWidth": null,
        "productHeight": null,
        "productVariationSelection": null,
        "shortDescription": null,
        "deliveryPeriod": "2-4",
        "description": "Customise your headphone in no time!",
        "title": "Boom - Customised headphone - Technic365",
        "productImage": "headphone3.jpg",
        "images": [
          {
            "url": "https://pm.epages.com/WebRoot/Store/Shops/apidocu/54EF/2E41/FCA8/E0E5/9323/0A0C/05E6/6C2E/001-headphone_h.jpg",
            "classifier": "HotDeal",
            "isZoomEnabled": true,
            "width": 149,
            "height": 84,
            "fileSize": 5168
          },
          {
            "url": "https://pm.epages.com/WebRoot/Store/Shops/apidocu/54EF/2E41/FCA8/E0E5/9323/0A0C/05E6/6C2E/001-headphone_m.jpg",
            "classifier": "Medium",
            "isZoomEnabled": true,
            "width": 500,
            "height": 281,
            "fileSize": 47289
          },
          {
            "url": "https://pm.epages.com/WebRoot/Store/Shops/apidocu/54EF/2E41/FCA8/E0E5/9323/0A0C/05E6/6C2E/headphone3.jpg",
            "classifier": "Large",
            "isZoomEnabled": true,
            "width": 1920,
            "height": 1080,
            "fileSize": 636262
          },
          {
            "url": "https://pm.epages.com/WebRoot/Store/Shops/apidocu/54EF/2E41/FCA8/E0E5/9323/0A0C/05E6/6C2E/001-headphone_s.jpg",
            "classifier": "Small",
            "isZoomEnabled": true,
            "width": 100,
            "height": 56,
            "fileSize": 2498
          },
          {
            "url": "https://pm.epages.com/WebRoot/Store/Shops/apidocu/54EF/2E41/FCA8/E0E5/9323/0A0C/05E6/6C2E/001-headphone_xs.jpg",
            "classifier": "Thumbnail",
            "isZoomEnabled": true,
            "width": 50,
            "height": 28,
            "fileSize": 1031
          }
        ],
        "priceInfo": {
          "quantity": {
            "amount": 1,
            "unit": "piece(s)"
          },
          "taxClass": {
            "taxClassId": "54B50D97-A277-9AF2-58A1-D5809AB32230",
            "name": "standard",
            "percentage": 19
          },
          "price": {
            "taxType": "NET",
            "formatted": "251.26 €",
            "amount": 251.26,
            "currency": "EUR"
          },
          "depositPrice": null,
          "ecoParticipationPrice": null,
          "priceWithDeposits": {
            "taxType": "NET",
            "formatted": "251.26 €",
            "amount": 251.26,
            "currency": "EUR"
          },
          "manufacturerPrice": null,
          "basePrice": null,
          "lowestPrice":null,
          "lowestRefPriceFormatted": null,
          "highestPrice": null
        },
        "forSale": true,
        "specialOffer": false,
        "deliveryWeight": {
          "amount": 350,
          "unit": "g"
        },
        "availabilityText": "available",
        "availability": "OnStock",
        "energyLabelsString": "B,D",
        "energyLabelsMaxEfficiencyString": "A+",
        "energyLabelSourceFile": "https://pm.epages.com/WebRoot/Store/Shops/apidocu/Products/be_40401/label-1-9dee85f24e1.png",
        "productDataSheet": null,
        "sfUrl": "http://pm.epages.com/epages/apidocu.sf/?ObjectPath=/Shops/apidocu/Products/Cust001",
        "productNumber": "Cust001",
        "isProductNumberVisible": true,
        "isNew": false,
        "isManufacturerPriceRRP": true,
        "isShippingLinkVisible": true,
        "isCustomizable": true,
        "customizableTextLength": 50,
        "customizableHeadlineText": "Customize your product",
        "newnessDate": "2023-08-08T00:00:00Z",
        "refAmount": 1,
        "refUnit": "piece",
        "refContentAmount": 1,
        "priceQuantity": 1,
        "orderUnit": "piece(s)",
        "minOrder": 1,
        "intervalOrder": 1,
        "productCode": null,
        "manufacturer": "Dr. Boom",
        "upc": null,
        "ean": null,
        "essentialFeatures": null,
        "searchKeywords":[  

        ],
        "stocklevel":10.0,
        "isInWishlist": false,
        "videos": [
          {
            "type": "YouTube",
            "source": "j-bj3nC7qss"
          },
          {
            "type": "Vimeo",
            "source": "https://vimeo.com/7265982"
          }
        ],
        "minStocklevel": null,
        "links": [
          {
            "rel": "self",
            "href": "https://pm.epages.com/rs/shops/apidocu/products/54EF2E41-FCA8-E0E5-9323-0A0C05E66C2E"
          },
          {
            "rel": "categories",
            "href": "https://pm.epages.com/rs/shops/apidocu/categories/?productId=54EF2E41-FCA8-E0E5-9323-0A0C05E66C2E"
          },
          {
            "rel": "producttype",
            "href": "https://pm.epages.com/rs/shops/apidocu/producttypes/6489A241-7B85-54B0-0B69-C0A8020205ED"
          }
        ]
      }
    ],
        "query":"headphone",
        "fallbackQuery":"",
        "facets":[
          {
            "attributeName":"Category",
            "attributeType":"Standard",
            "values":[
              {
                "matches":1,
                "name":"Headphones",
                "filter":{
                  "fieldName":"CategoryID",
                  "attributeValue":"22076"
                },
                "selectedValue":"22076"
              }
            ]
          },
          {
            "attributeName":"TestAttr",
            "attributeType":"PreDefString",
            "values":[
              {
                "matches":1,
                "name":"a",
                "filter":{
                  "fieldName":"PreDefString_de_-1082696253",
                  "attributeValue":"a"
                }
              }
            ]
          },
          {
            "attributeName":"ListPrice",
            "attributeType":"Standard",
            "values":[
              {
                "matches":-1,
                "name":"EUR",
                "filter":{
                  "fieldName":"ListPrice",
                  "attributeRange":{
                    "min":"1",
                    "max":"500"
                  }
                },
                "selectedRange":{
                  "min":"1",
                  "max":"500"
                }
              }
            ]
          }
        ]
      }