Filtering

To filter collections down to a particular set of items, you can add filters to your request as URL query parameters.

The maximum number of products returned is 250. Viewing more products requires creating a script that can loop through each subsequent page.

These are the most common filter options available for the V3 API:

Available filters vary by endpoint. For up-to-date information on supported filters, refer to the GET method documentation of each endpoint.

Include

Certain endpoints support the include query parameter used to include sub-resources and specific attributes in the primary GET response for a parent object. For example, you can include a product’s variants and images with the product response:

/v3/catalog/products?include=variants,images

The availability of the include query parameter varies by endpoint. For up-to-date filter information, refer to the GET method documentation of each endpoint.

Endpoints that support include are listed below. (Last updated on 09/28/2020.)

Include and exclude fields

Many of BigCommerce’s REST API endpoints support both include_fields and exclude_fields query parameters.

• include_fields query parameter will return ONLY the specified fields in the response.
• exclude_fields query parameter will omit the specified fields from the response.

You can request any field that is available on the object. Excluding unnecessary fields from your request (especially large fields like descriptions) can speed up your API request response time.

The following example shows product name and price included in a single request:

https://api.bigcommerce.com/stores/{{store_hash}}/v3/catalog/products?include_fields=name,price

Response:

{
    "data": [
        {
            "id": 77,
            "name": "Red printed scarf",
            "price": 12
        }    
    ]
} 

The availability of the include_fields and exclude_fields query parameters varies by endpoint. For up-to-date filter information, refer to the GET method documentation of each endpoint.

Endpoints that support include_fields and exclude_fields are listed below. (Last updated on 09/28/2020.)

Pagination and limit

page is the number of pages that are returned via api.

limit is the number of results per page that are returned.

page=2&limit=10 will return page 2 of the results with 10 items per page.