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.
Field | Type |
---|---|
term Search through any text indexed on a product, like name, descriptions, product codes, keywords, etc. | array[integer] |
categoryId | integer |
code | string |
oemCode | string |
eanCode | string |
manufacturer | string |
supplierCodes | array[string] |
textFilters | array[TextFilter] |
rangeFilers | array[RangeFilter] |
priceFilters | PriceFilter |
dateCreated | DateFilter |
dateModified | date (yyyy-mm-ddThh:nn:ss) |
orderBy | enum product_price= order by price product_name = order by name product_code = order by sku product_manufacturer = order by brand product_suppliercode = order by supplierCode product_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 |
orderDirection | enum ASC = ascending DESC = descending |
offset | integer |
page | integer |
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
- application/json
Body
Array [
]
Array [
]
dateCreated
object
dateModified
object
priceFilters
object
rangeFilters
object[]
textFilters
object[]
Responses
- 200