Product list

This functionality provides a list of products based on category, search term or filters that reflects the current list of products as would be organically shown to customers in the web shop for the specified country. This list is returned as if there are no sponsored slots.

We are constantly fine-tuning our search functionality in the web shop by running A/B tests. This endpoint always returns the ‘regular’ behaviour of search on our web shop. If you see a different list in the web shop than this endpoint, then you are part of one of these A/B tests in the web shop.

How can it help?

This endpoint helps you:

  • Identify the current organic ranking of a product within a specific category.

  • Identify the current organic ranking of a product on the search result page of a specific search term.

  • Analyze competitor’s products organically listed in product categories and on the search results pages.

  • Determine an effective strategy to improve your product’s content, offers or spot opportunities for your product assortment.

  • Define a strategy for improving the visibility of your products in the web shop through Promotions.

  • Determine in what position your currently sponsored product would be shown organically without sponsoring.

Identifying product ranking

Use the Get product list endpoint to retrieve a list of products in a paginated format that provides insights on the current position of a product within categories or on the search results pages for the specified country. It provides you with product titles and EANs of the products helping you determine a product’s current ranking in those lists.

Additionally, this endpoint offers you various sorting methods to filter the product list in a meaningful order.

To retrieve the ranking of a product:

  1. Specify the following parameters in the request body of this endpoint:

    • countryCode

    • searchTerm and/or categoryId

    • filterRanges

    • filterValues

    • Sorting method

    • Page number for which you want to retrieve the product list.

  2. In the response, this endpoint returns a list of all the products including their titles and EANs.

  3. Find the product of your interest and identify its current position within the list of products returned.

Aforementioned insights assist you in defining an effective strategy to identify opportunities and improve your product assortment on the web shop.

For more information on the request and response body of this endpoint, see the Redoc.