Bestseller API

What does the Bestseller API do?

The Bestseller API returns the products that are likely to generate the most revenue. The algorithm uses a combination of RPV, ATCs and Views, combined in order to maximize revenue.


The bestseller API doesn't return products according to their conversions only. If you need this behavior, then use the Search APIs and sort the results by best_seller in descending order with the sort parameter:

&sort=best_seller desc

This will return products sorted based on sitewide conversions.

If you are integrating JFY widgets on your site, then the Bestseller API provides the default content for these widgets until Bloomreach has enough information about individual site visitors to provide personalized recommendations and suggestions. For information about deploying JFY widgets, see Just for you (JFY) API.



Example request and response

account_id=<Bloomreach Provided Account ID>
&request_type=search #Value must be search for Bestseller API
&search_type=bestseller #Value must be bestseller for Bestseller API
response: {
    numFound: 93,
    start: 0,
        facet_queries: { },
    did_you_mean: [ ],
    category_map: { },


API requests should be limited to 16K Bytes. API requests above this length will throw Error Code 414.

Response fields

Parameter NameDescription
matchContainer for the core response details.
numFoundThe number of records (products) that the Bestseller response is based on, or the number of records that the Bestseller request retrieves.
startThe first page number of results.
docsA container for individual documents (products) and their fields.

Native mobile app and non-JS integration

API requests for native mobile apps or non-JS environments need different values for some parameters:

  • _br_uid_2: The value should be the same as described on the Cookie page. Generate a br_uid_2 for your app user and store it in the app permanently if a br_uid_2 does not exist. This br_uid_2 should be used on the corresponding API calls for the app. If the user is on iPhone and resets their IDFA, or if the user is on an Android device and resets their advertising settings: the br_uid_2 should be erased and regenerated the next time the app is set.
  • ref_url: Leave your ref_url parameters empty.
  • url: Use a dummy value for your url parameters, such as
Click Try It! to start a request and see the response here!