Documentation

catalog.product.list

catalog.product.list(select, filter, order, navigation)

The method gets list of commercial catalog products by filter.

When successful, returns list of products in the response body.

Parameters

Additionally, there are two additional values:
  • * – return all fields, including properties;
  • property_* – return values of all properties (not fields)

Both these values must be used only in case of extra necessity, because they can may create excessive server load.

Attention! Fields id and iblockId must be always specified, even when using the abovelisted keys.

Its recommended also to specify all fields which are used in the key order.
ParameterType Description
selectobject Fields, corresponding to the available list of getFieldsByFilter.
filterobject Fields, corresponding to the available list of getFieldsByFilter.
orderobject Fields, corresponding to the available list of getFieldsByFilter.
startstring Retrieved page number. Works for https queries.


Examples

For JS

BX24.callMethod(
    'catalog.product.list',
    {
    select: [
        'id',
        'iblockId',
        'name',
     ],
     filter:{
        'iblockId' : 14,
        '>property109':{
            value: '2019-03-01T16:10:00+02:00'
        }
     },
     order:{
        'id': 'ASC'
     },
    },
    function(result)
    {
        if(result.error())
            console.error(result.error().ex);
        else
            console.log(result.data());
        result.next();
});

For HTTPS

https://your_account/rest/catalog.product.list?auth=_authentication_key_&start=50

© «Bitrix24», 2001-2024