Skip to main content

Search Products

POST 

/products/search

> The product search endpoint is only available on the Propeller legacy version. The cloud version of Propeller does not support this API. Instead, use the GraphQL APIs to query products.

Retrieves a list of products by using the search fields below. Results will be paginated.

FieldType
term
Search through any text indexed on a product, like name, descriptions, product codes, keywords, etc.
array[integer]
categoryIdinteger
codestring
oemCodestring
eanCodestring
manufacturerstring
supplierCodesarray[string]
textFiltersarray[TextFilter]
rangeFilersarray[RangeFilter]
priceFiltersPriceFilter
dateCreatedDateFilter
dateModifieddate (yyyy-mm-ddThh:nn:ss)
orderByenum
product_price= order by price
product_name = order by name
product_code = order by skuproduct_manufacturer = order by brand
product_suppliercode = order by supplierCodeproduct_oemcode = order by oemCode
directory_order = order by dateCreated
product_supplier = order by supplier
container_name = order by category name
best_sold = order by number of times sold
orderDirectionenum
ASC = ascending
DESC = descending
offsetinteger
pageinteger

Product text filter

A text filter is used to search through text product fields and product attributes of type text, list, enum or enumlist, in which case searchId is the name of the attribute. When searching product fields, searchId can be:

  • searchproduct_code: sku
  • searchproduct_name: name
  • searchproduct_suppliercode: supplierCode
  • searchcode_supplier: supplier
  • searchcode_manufacturer:brand
  • searchproduct_oemcode: oemCode
  • searchproduct_container_name: name of parent category
{
"searchId": "MATERIAL_FRAME",
"value": "Leer"
}

Product range filter

A range filter is used to search through numeric product attributes i.e. attributes of type integer or decimal, in which case searchId is the name of the attribute.

{
"searchId": "WEIGHT",
"from": 65.2,
"to": 120
}

Product price filter

A price filter is a special price search object that can search through a range:

{
"from": 150.23,
"to": 500.25
}

Product date filter

A date filter is a special date search object that can search through a range:

{
"from": "2020-12-12T00:00:00",
"to": "2022-12-12T00:00:00"
}

Request

Responses