---
title: "Recommend Next Items"
method: POST
path: "/{databaseId}/recomms/next/items/{recommId}"
tags: ["Recommendations"]
---

# Recommend Next Items

`POST /{databaseId}/recomms/next/items/{recommId}`

Returns items that shall be shown to a user as next recommendations when the user e.g. scrolls the page down (*infinite scroll*) or goes to the next page.

It accepts `recommId` of a base recommendation request (e.g., request from the first page) and the number of items that shall be returned (`count`).
The base request can be one of:
  - [Recommend Items to Item](https://docs.recombee.com/api#recommend-items-to-item)
  - [Recommend Items to User](https://docs.recombee.com/api#recommend-items-to-user)
  - [Recommend Items to Item Segment](https://docs.recombee.com/api#recommend-items-to-item-segment)
  - [Search Items](https://docs.recombee.com/api#search-items)

All the other parameters are inherited from the base request.

*Recommend next items* can be called many times for a single `recommId` and each call returns different (previously not recommended) items.
The number of *Recommend next items* calls performed so far is returned in the `numberNextRecommsCalls` field.

*Recommend next items* can be requested up to 30 minutes after the base request or a previous *Recommend next items* call.

For billing purposes, each call to *Recommend next items* is counted as a separate recommendation request.

## Path parameters

- `databaseId` string, required
- `recommId` string, required

## Request body

- RecommendNextItemsParameters
  - `count` integer, required — Number of items to be recommended

## Response `200`

Successful operation.

- RecommendationResponse
  - `recommId` string, required — Id of the recommendation request
  - `recomms` Recommendation[], required — Obtained recommendations
    - `id` string, required — Id of the recommended item
    - `values` object — Property values of the recommended item
    - `reqlEvaluations` object — Dictionary of evaluated ReQL expressions specified in the request and calculated for the recommended item. The keys are the names of the ReQL expressions, and the values are the results of the evaluations.
  - `numberNextRecommsCalls` integer — How many times *Recommend Next Items* have been called for this `recommId`
  - `abGroup` string — Name of AB-testing group to which the request belongs if there is a custom AB-testing running.

## Other responses

- `400` — Parameter `count` is not given or is not a positive integer. Parameter `recommId` is not an UUID.
- `404` — Base request with the given `recommId` does not exist or has expired.

---

[API](https://skmtc.dev/recombee/apis/recombee-api.md) · [All operations](https://skmtc.dev/recombee/apis/recombee-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recombee/recombee-api/revisions/a9c9c33eb2e8/schema)