oxcom/magento2-top-products

This is a module that extends Magento2 API to get list of TOP products.

v1.1.0 2021-01-11 11:27 UTC

Requires

• php: >=5.6
• magento/framework: 100.0.*|100.1.*|101.0.*|102.0.*|103.0.*
• magento/module-backend: 100.0.*|100.1.*|100.2.*|101.0.*|102.0.*|103.0.*
• magento/module-config: 100.0.*|100.1.*|101.0.*|101.1.*|101.2.*
• magento/module-directory: 100.0.*|100.1.*|100.2.*|100.3.*|100.4.*
• magento/module-store: 100.0.*|100.1.*|100.2.*|101.0.*|101.1.*

Requires (Dev)

• magento/zendframework1: 1.12.*|1.13.*|1.14.*
• phpunit/phpunit: 5.3.5|^7.5.20|^9.3.8
• squizlabs/php_codesniffer: ^3.5.8

LGPL-3.0

• OxCom

• api
• magento2
• top products

README

This is a module that extends Magento2 API to get list of TOP products by next filters:

• TOP selling products
• TOP Free products
• TOP Rated products

Top selling and free products are fetching from Magento2 reports.

Top rated products are fetching from Rates module and results are based on aggregated data.

Install

$ composer require oxcom/magento2-top-products
$ bin/magento module:enable OxCom_MagentoTopProducts
$ bin/magento setup:upgrade
$ bin/magento setup:di:compile

API requests

GET /V1/products/top/{type} - Get list of top products by type. Where type can be:

• selling - TOP selling products
• free - TOP Free products
• rated - TOP Rated products

Search criteria params

pageSize - Page size

currentPage - Current page

ratingCode - filter by rating type. This options is related ony for rated type. Possible values can be found in rating table.

period - filter by period. This options is related only for selling or free type. Possible values are:

• yearly - annual report (default)
• monthly - monthly report
• daily - daily report

filter_groups - As product search criteria this filter will allow you to process products collection with more requirements.

Search criteria examples:

Filter top selling products by:

• period: daily
• price > 10
• visibility = 4
• pageSize = 10
• currentPage = 2

$ curl -X GET \
  'https://example.com/rest/all/V1/products/top/selling?searchCriteria%5Bfilter_groups%5D%5B0%5D%5Bfilters%5D%5B0%5D%5Bfield%5D=visibility&searchCriteria%5Bfilter_groups%5D%5B0%5D%5Bfilters%5D%5B0%5D%5Bvalue%5D=4&searchCriteria%5Bfilter_groups%5D%5B0%5D%5Bfilters%5D%5B0%5D%5Bcondition_type%5D=eq&searchCriteria%5BpageSize%5D=10&searchCriteria%5BcurrentPage%5D=2&searchCriteria%5Bfilter_groups%5D%5B0%5D%5Bfilters%5D%5B1%5D%5Bfield%5D=price&searchCriteria%5Bfilter_groups%5D%5B0%5D%5Bfilters%5D%5B1%5D%5Bvalue%5D=10&searchCriteria%5Bfilter_groups%5D%5B0%5D%5Bfilters%5D%5B1%5D%5Bcondition_type%5D=gt&searchCriteria%5Bperiod%5D=daily' \
  -H 'authorization: Bearer {api-token}' \
  -H 'cache-control: no-cache'

Filter top rated products by:

• ratingCode: Rating
• status = 2
• visibility = 4
• pageSize = 10
• currentPage = 2

$ curl -X GET \
  'https://example.com/rest/all/V1/products/top/rated?searchCriteria%5Bfilter_groups%5D%5B0%5D%5Bfilters%5D%5B0%5D%5Bfield%5D=visibility&searchCriteria%5Bfilter_groups%5D%5B0%5D%5Bfilters%5D%5B0%5D%5Bvalue%5D=4&searchCriteria%5Bfilter_groups%5D%5B0%5D%5Bfilters%5D%5B0%5D%5Bcondition_type%5D=eq&searchCriteria%5BpageSize%5D=10&searchCriteria%5BcurrentPage%5D=2&searchCriteria%5Bfilter_groups%5D%5B0%5D%5Bfilters%5D%5B1%5D%5Bfield%5D=status&searchCriteria%5Bfilter_groups%5D%5B0%5D%5Bfilters%5D%5B1%5D%5Bvalue%5D=1&searchCriteria%5Bfilter_groups%5D%5B0%5D%5Bfilters%5D%5B1%5D%5Bcondition_type%5D=eq&searchCriteria%5BratingCode%5D=Rating' \
  -H 'authorization: Bearer {api-token}' \
  -H 'cache-control: no-cache'

Dependencies

This module is using exists functionality of next modules:

• magento/module-catalog
• magento/module-review
• magento/module-sales

Bugs and Issues

Please, if You found a bug or something, that is not working properly, contact me and tell what's wrong. It's nice to have an example how to reproduce a bug, or any idea how to fix it in Your request. I'll take care about it ASAP.